modules.html.ja.utf8 revision 30471a4650391f57975f60bbb6e4a90be7b284bf
6ae232055d4d8a97267517c5e50074c2c819941and<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
6ae232055d4d8a97267517c5e50074c2c819941and<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
6ae232055d4d8a97267517c5e50074c2c819941and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
6ae232055d4d8a97267517c5e50074c2c819941and This file is generated from xml source: DO NOT EDIT
6ae232055d4d8a97267517c5e50074c2c819941and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
6ae232055d4d8a97267517c5e50074c2c819941and<title>モジュールの Apache 1.3 から Apache 2.0 への移植 - Apache HTTP サーバ</title>
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<script src="/style/scripts/prettify.js" type="text/javascript">
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/images/favicon.ico" rel="shortcut icon" /></head>
d229f940abfb2490dee17979e9a5ff31b7012eb5rbowen<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>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
b43f840409794ed298e8634f6284741f193b6c4ftakashi<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> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>モジュールの Apache 1.3 から Apache 2.0 への移植</h1>
b43f840409794ed298e8634f6284741f193b6c4ftakashi<p><span>翻訳済み言語: </span><a href="/en/developer/modules.html" hreflang="en" rel="alternate" title="English"> en </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/ja/developer/modules.html" title="Japanese"> ja </a></p>
b43f840409794ed298e8634f6284741f193b6c4ftakashi 最近更新された内容を見るには英語版をご覧下さい。
6ae232055d4d8a97267517c5e50074c2c819941and <p>この文書は <code>mod_mmap_static</code> モジュールを Apache 2.0 用に移植した時に
6ae232055d4d8a97267517c5e50074c2c819941and 学んだ経験をもとに書いた、最初の手引き書です。まだまだ完全じゃないし、
6ae232055d4d8a97267517c5e50074c2c819941and ひょっとすると間違っている部分もあるかもしれませんが、
6ae232055d4d8a97267517c5e50074c2c819941and 取っ掛りにはなるでしょう。</p>
6ae232055d4d8a97267517c5e50074c2c819941and<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#easy">簡単な変更点</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><img alt="" src="/images/down.gif" /> <a href="#messy">もっと厄介な変更点…</a></li>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh</ul><ul class="seealso"><li><a href="#comments_section">コメント</a></li></ul></div>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and そして、apr_status_t 型の値を返さなくてはなりません。
6ae232055d4d8a97267517c5e50074c2c819941and クリーンナップ中のエラーを通知する必要がなければ、返り値は普通、
6ae232055d4d8a97267517c5e50074c2c819941and すべてのコードがその通知をチェックしたり、
6ae232055d4d8a97267517c5e50074c2c819941and エラーに応じた動作をするわけではないことに気をつけてください。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>初期化ルーチンは処理全体から見てしっくりくるような意味を表すように、
6ae232055d4d8a97267517c5e50074c2c819941and 名前が変更されました。ですから、<code>mmap_init</code> から <code>mmap_post_config</code>
6ae232055d4d8a97267517c5e50074c2c819941and のようにちょっと変更されました。
6ae232055d4d8a97267517c5e50074c2c819941and 渡される引数は大幅に変更され、次のようになりました。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>データ型のほとんどは <a href="http://apr.apache.org/">APR</a> に移されました。つまり、
6ae232055d4d8a97267517c5e50074c2c819941and いくつかの名前が前述のように変更されています。
6ae232055d4d8a97267517c5e50074c2c819941and 施すべき変更点の簡単な一覧を以下に示します。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <li><code>pool</code> becomes <code>apr_pool_t</code></li>
6ae232055d4d8a97267517c5e50074c2c819941and <li><code>table</code> becomes <code>apr_table_t</code></li>
6ae232055d4d8a97267517c5e50074c2c819941and</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and <h3><a name="register-hooks" id="register-hooks">フックの登録</a></h3>
6ae232055d4d8a97267517c5e50074c2c819941and <p>新しいアーキテクチャでは作成した関数を呼び出すのに
6ae232055d4d8a97267517c5e50074c2c819941and 一連のフックを使用します。このフックは、新しい関数
6ae232055d4d8a97267517c5e50074c2c819941and <code>static void register_hooks(void)</code> を使って登録するよう、
6ae232055d4d8a97267517c5e50074c2c819941and モジュールに書き足さなくてはなりません。
6ae232055d4d8a97267517c5e50074c2c819941and この関数は、なにをすべきか一旦理解してしまえば、
6ae232055d4d8a97267517c5e50074c2c819941and 十分にわかりやすいものです。
6ae232055d4d8a97267517c5e50074c2c819941and リクエストの処理のあるステージで呼び出さなくてはならない
6ae232055d4d8a97267517c5e50074c2c819941and 関数は登録する必要があります。ハンドラは登録する必要はありません。
6ae232055d4d8a97267517c5e50074c2c819941and 関数を登録できるフェーズはたくさんあります。
6ae232055d4d8a97267517c5e50074c2c819941and それぞれのフェーズで、関数を呼び出す相対的な順番は、
6ae232055d4d8a97267517c5e50074c2c819941and かなりの程度制御できます。</p>
6ae232055d4d8a97267517c5e50074c2c819941andstatic void register_hooks(void)
6ae232055d4d8a97267517c5e50074c2c819941and static const char * const aszPre[]={ "http_core.c",NULL };
6ae232055d4d8a97267517c5e50074c2c819941and ap_hook_post_config(mmap_post_config,NULL,NULL,HOOK_MIDDLE);
6ae232055d4d8a97267517c5e50074c2c819941and ap_hook_translate_name(mmap_static_xlat,aszPre,NULL,HOOK_LAST);
6ae232055d4d8a97267517c5e50074c2c819941and <p>ここでは呼びだすべき二つの関数を登録しています。一つは
6ae232055d4d8a97267517c5e50074c2c819941and それぞれの関数は名前は違うけれども形式は同じであることに注意してください。
6ae232055d4d8a97267517c5e50074c2c819941and それでは、形式はどのようになっているでしょうか?</p>
6ae232055d4d8a97267517c5e50074c2c819941and <var>predecessors</var>, <var>successors</var>, <var>position</var>);
6ae232055d4d8a97267517c5e50074c2c819941and <p>位置を定義するには、上記の「位置」を指定し、
6ae232055d4d8a97267517c5e50074c2c819941and 修飾子である「先行」と「後行」で手を加えます。
6ae232055d4d8a97267517c5e50074c2c819941and 「先行」「後行」は、呼ばれるべき関数のリストです。
6ae232055d4d8a97267517c5e50074c2c819941and 「先行」は関数の実行前に呼ばれるもので、
6ae232055d4d8a97267517c5e50074c2c819941and 「後行」は実行後に呼ばれるものです。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p><code>mod_mmap_static</code> の場合、<code>post_config</code>
6ae232055d4d8a97267517c5e50074c2c819941and ステージでは必要ありませんが、
6ae232055d4d8a97267517c5e50074c2c819941and <p>モジュールの定義を作成する際に注意しなければならない
6ae232055d4d8a97267517c5e50074c2c819941and ステージの数は激減しています。古い定義は次のようになっていました。</p>
6ae232055d4d8a97267517c5e50074c2c819941and STANDARD_MODULE_STUFF,
6ae232055d4d8a97267517c5e50074c2c819941and /* initializer */
6ae232055d4d8a97267517c5e50074c2c819941and /* dir config creater */
6ae232055d4d8a97267517c5e50074c2c819941and /* dir merger --- default is to override */
6ae232055d4d8a97267517c5e50074c2c819941and /* server config */
6ae232055d4d8a97267517c5e50074c2c819941and /* merge server config */
6ae232055d4d8a97267517c5e50074c2c819941and /* command handlers */
6ae232055d4d8a97267517c5e50074c2c819941and /* handlers */
6ae232055d4d8a97267517c5e50074c2c819941and /* filename translation */
6ae232055d4d8a97267517c5e50074c2c819941and /* check_user_id */
6ae232055d4d8a97267517c5e50074c2c819941and /* check auth */
6ae232055d4d8a97267517c5e50074c2c819941and /* check access */
6ae232055d4d8a97267517c5e50074c2c819941and /* type_checker */
6ae232055d4d8a97267517c5e50074c2c819941and /* fixups */
6ae232055d4d8a97267517c5e50074c2c819941and /* logger */
6ae232055d4d8a97267517c5e50074c2c819941and /* header parser */
6ae232055d4d8a97267517c5e50074c2c819941and /* child_init */
6ae232055d4d8a97267517c5e50074c2c819941and /* child_exit */
6ae232055d4d8a97267517c5e50074c2c819941and /* post read-request */
6ae232055d4d8a97267517c5e50074c2c819941and STANDARD20_MODULE_STUFF,
6ae232055d4d8a97267517c5e50074c2c819941and /* create per-directory config structures */
6ae232055d4d8a97267517c5e50074c2c819941and /* merge per-directory config structures */
6ae232055d4d8a97267517c5e50074c2c819941and /* create per-server config structures */
6ae232055d4d8a97267517c5e50074c2c819941and /* merge per-server config structures */
6ae232055d4d8a97267517c5e50074c2c819941and /* command handlers */
6ae232055d4d8a97267517c5e50074c2c819941and /* handlers */
6ae232055d4d8a97267517c5e50074c2c819941and /* register hooks */
6ae232055d4d8a97267517c5e50074c2c819941and <p>このうちのいくつかは古いものから新しいものに直接読み替えられるもので、
6ae232055d4d8a97267517c5e50074c2c819941and いくつかはそうではありません。どうすればいいのかを要約してみます。</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>古い関数の残りのものはフックとして登録されるべきです。
6ae232055d4d8a97267517c5e50074c2c819941and 現時点で次のようなフック・ステージが定義されています…</p>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>(モジュールにヘッダの照会をさせる。ほとんどのモジュールでは使われません。post_read_request を使います)</dd>
6ae232055d4d8a97267517c5e50074c2c819941and <dd>リクエストの処理が始まる前に呼ばれる。キャッシュモジュールが
6ae232055d4d8a97267517c5e50074c2c819941and 使用している</dd>
b43f840409794ed298e8634f6284741f193b6c4ftakashi<p><span>翻訳済み言語: </span><a href="/en/developer/modules.html" hreflang="en" rel="alternate" title="English"> en </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/ja/developer/modules.html" title="Japanese"> ja </a></p>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh</div><div class="top"><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>This section is experimental!</strong><br />Comments placed here should not be expected
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohto last beyond the testing phase of this system, nor do we in any way guarantee that we'll read them.</div><div id="disqus_thread" /><script type="text/javascript"><!--//--><![CDATA[//><!--
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohvar lang = 'ja';
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohvar disqus_shortname = 'httpd';
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohvar disqus_identifier = window.location.href.replace(/(current|trunk)/, "2.4").replace(/\/[a-z]{2}\//, "/").replace(window.location.protocol, "http:") + '.' + lang;
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedoohif (disqus_identifier.indexOf("httpd.apache.org") != -1) {
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh (function() {
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh dsq.src = window.location.protocol + '//' + disqus_shortname + '.disqus.com/embed.js';
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh var text = document.createTextNode("Comments have been disabled for offline viewing.");
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh document.getElementById('disqus_thread').appendChild(text);
b43f840409794ed298e8634f6284741f193b6c4ftakashi<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>
d229f940abfb2490dee17979e9a5ff31b7012eb5rbowen<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[//><!--
7fec19672a491661b2fe4b29f685bc7f4efa64d4ndif (typeof(prettyPrint) !== undefined) {
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd prettyPrint();