1 <?xml version=
"1.0" encoding=
"UTF-8"?>
2 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns=
"http://www.w3.org/1999/xhtml" lang=
"ja" xml:
lang=
"ja"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>mod_so - Apache HTTP サーバ
</title>
9 <link href=
"../style/css/manual.css" rel=
"stylesheet" media=
"all" type=
"text/css" title=
"Main stylesheet" />
10 <link href=
"../style/css/manual-loose-100pc.css" rel=
"alternate stylesheet" media=
"all" type=
"text/css" title=
"No Sidebar - Default font size" />
11 <link href=
"../style/css/manual-print.css" rel=
"stylesheet" media=
"print" type=
"text/css" />
12 <link href=
"../images/favicon.ico" rel=
"shortcut icon" /></head>
14 <div id=
"page-header">
15 <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>
16 <p class=
"apache">Apache HTTP サーバ バージョン
2.3</p>
17 <img alt=
"" src=
"../images/feather.gif" /></div>
18 <div class=
"up"><a href=
"./"><img title=
"<-" alt=
"<-" src=
"../images/left.gif" /></a></div>
20 <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=
"../">バージョン
21 2.3</a> > <a href=
"./">モジュール
</a></div>
22 <div id=
"page-content">
23 <div id=
"preamble"><h1>Apache モジュール mod_so
</h1>
25 <p><span>言語:
</span><a href=
"../en/mod/mod_so.html" hreflang=
"en" rel=
"alternate" title=
"English"> en
</a> |
26 <a href=
"../ja/mod/mod_so.html" title=
"Japanese"> ja
</a> |
27 <a href=
"../ko/mod/mod_so.html" hreflang=
"ko" rel=
"alternate" title=
"Korean"> ko
</a> |
28 <a href=
"../tr/mod/mod_so.html" hreflang=
"tr" rel=
"alternate" title=
"Türkçe"> tr
</a></p>
30 <table class=
"module"><tr><th><a href=
"module-dict.html#Description">説明:
</a></th><td>起動時や再起動時に実行コードとモジュールをサーバにロードする
32 <tr><th><a href=
"module-dict.html#Status">ステータス:
</a></th><td>Extension
</td></tr>
33 <tr><th><a href=
"module-dict.html#ModuleIdentifier">モジュール識別子:
</a></th><td>so_module
</td></tr>
34 <tr><th><a href=
"module-dict.html#SourceFile">ソースファイル:
</a></th><td>mod_so.c
</td></tr>
35 <tr><th><a href=
"module-dict.html#Compatibility">互換性:
</a></th><td>このモジュールは Window では (常に含まれている) Base
36 モジュールです
</td></tr></table>
40 <p>いくつかのオペレーティングシステムでは、サーバの再コンパイルをする代わりに、
42 <a href=
"../dso.html">動的共有オブジェクト
</a>
43 (DSO) 機構により、実行時に Apache にモジュールを読み込ませることが
46 <p>Unix 上では、読み込まれるコードは通常は共有オブジェクトファイル
47 (普通
<code>.so
</code> という拡張子が付いています) からです。
48 Windows 上ではこのモジュールの拡張子は
<code>.so
</code> か
<code>.dll
</code>
51 <div class=
"warning"><h3>警告
</h3>
52 <p>Apache
1.3 のモジュールを直接 Apache
2.0 で使うことはできません
53 ― モジュールは Apache
2.0 用に動的にロードされるか、
54 直接組み込まれるために修正されなければなりません。
</p>
57 <div id=
"quickview"><h3 class=
"directives">ディレクティブ
</h3>
59 <li><img alt=
"" src=
"../images/down.gif" /> <a href=
"#loadfile">LoadFile
</a></li>
60 <li><img alt=
"" src=
"../images/down.gif" /> <a href=
"#loadmodule">LoadModule
</a></li>
64 <li><img alt=
"" src=
"../images/down.gif" /> Windows 用のロード可能なモジュールを作成する
</li>
66 <div class=
"top"><a href=
"#page-header"><img alt=
"top" src=
"../images/up.gif" /></a></div>
68 <h2>Windows 用のロード可能なモジュールを作成する
</h2>
70 <div class=
"note"><h3>注
</h3>
71 <p>Apache
1.3.15 と
2.0 とで Windows のモジュール名の形式は変更されました
72 ― モジュールは mod_foo.so という名前になりました。
</p>
74 <p>まだ mod_so で ApacheModuleFoo.dll という名前のモジュールも
75 ロードされますが、新しい名前の付け方を使う方が好まれます。モジュールを
76 2.0 用に移植しているのであれば、
2.0 の習慣に合うように名前を
79 <p>Apache のモジュール API は UNIX と Windows 間では変更されていません。
80 多くのモジュールは全く変更なし、もしくは簡単な変更により Windows
81 で実行できるようになります。ただし、それ以外の Windows には無い Unix
82 アーキテクチャーの機能に依存したモジュールは動作しません。
</p>
85 二つの方法のどちらかでサーバに追加することができます。まず、Unix
86 と同様にサーバにコンパイルして組み込むことができます。Windows
87 用の Apache は Unix 用の Apache にある
<code>Configure
</code>
88 プログラムがありませんので、モジュールのソースファイルを
89 ApacheCore プロジェクトファイルに追加し、シンボルを
90 <code>os\win32\modules.c
</code> ファイルに追加する必要があります。
</p>
92 <p>二つ目はモジュールを DLL としてコンパイルする方法です。
94 <code><code class=
"directive">LoadModule
</code></code>
95 ディレクティブによりサーバに読み込むことができます。これらのモジュール
96 DLL はそのまま配布することが可能で、サーバを再コンパイルすることなく、Windows
97 用の Apache のすべてのインストールで実行することができます。
</p>
99 <p>モジュール DLL を作成するためには、
100 モジュールの作成に小さな変更を行なう必要があります。
101 つまり、モジュールのレコード (これは後で作成されます。
102 以下を参照してください) が DLL からエクスポートされなければなりません。
103 これを行なうには、
<code>AP_MODULE_DECLARE_DATA
</code> (Apache
104 のヘッダファイルで定義されています) をモジュールのモジュールレコード
105 定義の部分に追加してください。たとえば、モジュールに
</p>
106 <div class=
"example"><p><code>
110 <p>があるとすると、それを次のもので置き換えてください。
</p>
111 <div class=
"example"><p><code>
112 module AP_MODULE_DECLARE_DATA foo_module;
116 変更無しで使い続けられるように、このマクロは Windows
117 上でのみ効力を持ちます。
<code>.DEF
</code>
118 ファイルの方を良く知っているという場合は、
121 <p>さあ、あなたのモジュールの DLL を作成しましょう。これを、
122 libhttpd.lib 共有ライブラリがコンパイルされたときに作成された
123 ibhttpd.lib エクスポートライブラリとリンクしてください。この時に、
124 Apache のヘッダファイルが正しい位置にあるように、
125 コンパイラの設定を変える必要があるかもしれません。
126 このライブラリはサーバルートの modules ディレクトリにあります。
127 ビルド環境が正しく設定されるように、既存のモジュール用の .dsp を
128 取ってくるのが一番良いでしょう。もしくは、あなたの .dsp と
129 コンパイラとリンクのオプションを比較する、というものでも良いです。
</p>
131 <p>これで DLL 版のモジュールが作成されているはずです。
132 サーバルートの
<code>modules
</code>
134 <code><code class=
"directive">LoadModule
</code></code>
135 ディレクティブを使って読み込んでください。
</p>
137 <div class=
"top"><a href=
"#page-header"><img alt=
"top" src=
"../images/up.gif" /></a></div>
138 <div class=
"directive-section"><h2><a name=
"LoadFile" id=
"LoadFile">LoadFile
</a> <a name=
"loadfile" id=
"loadfile">ディレクティブ
</a></h2>
139 <table class=
"directive">
140 <tr><th><a href=
"directive-dict.html#Description">説明:
</a></th><td>指定されたオブジェクトファイルやライブラリをリンクする
</td></tr>
141 <tr><th><a href=
"directive-dict.html#Syntax">構文:
</a></th><td><code>LoadFile
<em>filename
</em> [
<em>filename
</em>] ...
</code></td></tr>
142 <tr><th><a href=
"directive-dict.html#Context">コンテキスト:
</a></th><td>サーバ設定ファイル
</td></tr>
143 <tr><th><a href=
"directive-dict.html#Status">ステータス:
</a></th><td>Extension
</td></tr>
144 <tr><th><a href=
"directive-dict.html#Module">モジュール:
</a></th><td>mod_so
</td></tr>
147 <p>LoadFile ディレクティブは、サーバが起動されたときや再起動されたときに、
148 指定されたオブジェクトファイルやライブラリをリンクします。
149 これはモジュールが動作するために必要になるかもしれない追加の
150 コードを読み込むために使用されます。
<em>Filename
</em> は絶対パスか、
<a href=
"core.html#serverroot">ServerRoot
</a> からの相対パスです。
</p>
154 <div class=
"example"><p><code>LoadFile libexec/libxmlparse.so
</code></p></div>
158 <div class=
"top"><a href=
"#page-header"><img alt=
"top" src=
"../images/up.gif" /></a></div>
159 <div class=
"directive-section"><h2><a name=
"LoadModule" id=
"LoadModule">LoadModule
</a> <a name=
"loadmodule" id=
"loadmodule">ディレクティブ
</a></h2>
160 <table class=
"directive">
161 <tr><th><a href=
"directive-dict.html#Description">説明:
</a></th><td>オブジェクトファイルやライブラリをリンクし、使用モジュールの
163 <tr><th><a href=
"directive-dict.html#Syntax">構文:
</a></th><td><code>LoadModule
<em>module filename
</em></code></td></tr>
164 <tr><th><a href=
"directive-dict.html#Context">コンテキスト:
</a></th><td>サーバ設定ファイル
</td></tr>
165 <tr><th><a href=
"directive-dict.html#Status">ステータス:
</a></th><td>Extension
</td></tr>
166 <tr><th><a href=
"directive-dict.html#Module">モジュール:
</a></th><td>mod_so
</td></tr>
169 <p>LoadModule ディレクティブは
<em>filename
</em>
170 というオブジェクトファイルおよびライブラリをリンクし、
<em>module
</em>
171 という名前のモジュールの構造をアクティブなモジュールのリストに追加します。
172 <em>Module
</em> はファイル中の
<code>module
</code>
173 型の外部変数の名前で、モジュールのドキュメントに
174 <a href=
"module-dict.html#moduleidentifier">モジュール識別子
</a>として書かれているものです。例 :
</p>
176 <div class=
"example"><p><code>
177 LoadModule status_module modules/mod_status.so
180 <p>これは ServerRoot の modules サブディレクトリから指定された名前の
185 <div class=
"bottomlang">
186 <p><span>言語:
</span><a href=
"../en/mod/mod_so.html" hreflang=
"en" rel=
"alternate" title=
"English"> en
</a> |
187 <a href=
"../ja/mod/mod_so.html" title=
"Japanese"> ja
</a> |
188 <a href=
"../ko/mod/mod_so.html" hreflang=
"ko" rel=
"alternate" title=
"Korean"> ko
</a> |
189 <a href=
"../tr/mod/mod_so.html" hreflang=
"tr" rel=
"alternate" title=
"Türkçe"> tr
</a></p>
190 </div><div id=
"footer">
191 <p class=
"apache">Copyright
2009 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>
192 <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>