handler.html.ja.utf8 revision b43f840409794ed298e8634f6284741f193b6c4f
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache のハンドラの使用 - Apache HTTP サーバ</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/directives.html">ディレクティブ</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.5</p>
<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.5</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="/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"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#definition">ハンドラとは</a></li>
</ul></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>ハンドラの両方を関連付けることができるという点で優れています。
<p>ハンドラはサーバに組み込んだり、モジュールとして含めたり、
ディレクティブとして追加したりすることができます。
以下は標準配布に組み込まれているハンドラです。
</p>
<ul>
<li><strong>default-handler</strong>:<code>default_handelr()</code>
を使ってファイルを送ります。
静的なコンテンツを扱うときにデフォルトで使用されるハンドラです。
<li><strong>send-as-is</strong>:
HTTP ヘッダのあるファイルをそのまま送ります。
<li><strong>cgi-script</strong>: ファイルを CGI
スクリプトとして扱います。
<li><strong>imap-file</strong>:
イメージマップのルールファイルとして解析します。
<li><strong>server-info</strong>: サーバの設定情報を取得します。
<li><strong>server-status</strong>: サーバの状態報告を取得します。
<li><strong>type-map</strong>:
コンテントネゴシエーションのためのタイプマップとして解析します。
</ul>
<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 スクリプトを起動するようになります。</p>
<div class="example"><p><code>
AddHandler add-footer .html
</code></p></div>
<p>CGI スクリプトは希望の修正や追加を行なって、元々要求された文書
(環境変数 <code>PATH_TRANSLATED</code>
で指されています) を送る責任があります。
</p>
<h3><a name="example2" id="example2">HTTP ヘッダのあるファイル</a></h3>
<p>以下のディレクティブは <code>send-as-is</code>
ハンドラを使用するように指示します。このハンドラは自分自身の HTTP
ヘッダを持っているファイルに使用されます。ここでは、拡張子に関わらず、
<code>send-as-is</code> ハンドラによって扱われます。</p>
<div class="example"><p><code>
SetHandler send-as-is<br />
</Directory>
</code></p></div>
<div class="section">
<h2><a name="programmer" id="programmer">プログラマ向けのメモ</a></h2>
<p>ハンドラの機能を実装するために、利用すると便利かもしれないものが
に追加されました。詳しく言うと、<code>request_rec</code>
構造体に新しいレコードが追加されたということです。</p>
<div class="example"><p><code>
char *handler
</code></p></div>
<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="/zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2012 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="/faq/">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p></div>
</body></html>