このモジュールは、サーバの起動時や再起動時に実行コードと モジュールをサーバに読み込む機能を提供します。
ステータス:
Base (Windows); Experimental (Unix)
ソースファイル: mod_so.c
モジュール識別子:
so_module
互換性:
Apache 1.3 以降で使用可能。
これは実験的なモジュールです。 オペレーティングシステムによっては、再コンパイルを要求する代わりに、 Dynamic Shared Object (DSO) 機構により、実行時に Apache にモジュールを読み込むために このモジュールを使用することができます。
Unix 上では、読み込まれるコードは通常はシェアードオブジェクトファイル (普通 .so という拡張子が付いています) からです。 一方、Windows 上ではこのモジュールは DLL ファイルを読み込みます。このモジュールは Apache 1.3 以降のみで使用可能です。
以前のリリースでは、このモジュールの機能は Unix では mod_dld、 Windows では mod_dll により提供されていました。Windows では、 mod_dll は 1.3b1 から 1.3b5 までのベータリリースで使用されていました。 mod_so はすべてのオペレーティングシステム用に、 この二つのモジュールを一つのモジュールにまとめたものです。
Apache のモジュール API は UNIX と Windows とで変更されていません。 多くのモジュールは全く変更なし、もしくは簡単な変更により Windows で実行できるようになります。ただし、その他の Windows には無い Unix アーキテクチャーの機能に依存したモジュールは動作しません。
モジュールが実際に動作するときは、
二つの方法のどちらかでサーバに追加することができます。まず、Unix
と同様にサーバにコンパイルして組み込むことができます。Windows
用の Apache は Unix 用の Apache にある Configure
プログラムがありませんので、モジュールのソースファイルを
ApacheCore プロジェクトファイルに追加し、シンボルを
os\win32\modules.c ファイルに追加する必要があります。
二つ目はモジュールを DLL としてコンパイルする方法です。
DLL はシェアードライブラリで、実行時に
LoadModule
ディレクティブによりサーバに読み込むことができます。これらのモジュール
DLL は配布することが可能で、サーバを再コンパイルすることなく、Windows
用の Apache のすべてのインストールで実行することができます。
モジュール DLL を作成するためには、
モジュールの作成に小さな変更を行なう必要があります。
つまり、モジュールのレコードが DLL (これは後で作成されます。
以下を参照してください) からエクスポートされなければなりません。
これを行なうには、MODULE_VAR_EXPORT (Apache
のヘッダファイルで定義されています) をモジュールのモジュールレコード
定義の部分に追加してください。たとえば、モジュールに
module foo_module;
があるとすると、それを次のもので置き換えてください。
module MODULE_VAR_EXPORT foo_module;
必要ならば Unix
で変更無しにモジュールが使い続けられるように、このマクロは Windows
上でのみ使用されるということに注意してください。.DEF
ファイルに詳しいなら、代わりにそれを使ってモジュールレコードを
エクスポートすることもできます。
ここで、あなたのモジュールの DLL を作成してください。これを、 ApacheCore.dll シェアードライブラリがコンパイルされたときに作成された ApacheCore.lib エクスポートライブラリとリンクしてください。この時に、 Apache のヘッダファイルが正しい位置にあることを確実にするために コンパイラの設定を変える必要があるかもしれません。
これで DLL 版のモジュールが作成されているはずです。
さあ、単純にサーバルートの modules
ディレクトリにモジュールを置いて、LoadModule
ディレクティブを使って読み込んでください。
LoadFile ディレクティブは、サーバが起動されたときか再起動されたときに、 指定されたオブジェクトファイルやライブラリをリンクします。 これはモジュールが動作するために必要になるかもしれない追加の コードを読み込みます。Filename は絶対パスか、ServerRoot からの相対パスです。
LoadModule ディレクティブは filename
というオブジェクトファイルおよびライブラリをリンクし、module
という名前のモジュールの構造をアクティブなモジュールのリストに追加します。
Module はファイル中の module
型の外部変数の名前で、モジュールのドキュメントに
モジュール識別子として書かれているものです。例
(Unix と Apache 1.3.15 以降の Windows):
LoadModule status_module modules/mod_status.so
例 (Apache 1.3.15 以前の Windows、サードパーティモジュールの一部):
LoadModule foo_module modules/ApacheModuleFoo.dll
Apache 1.3.15 で Apache Win32 バイナリ配布に付属している すべてのモジュールの名前が変更されたことに注意してください。
Win32 Apache モジュールはしばしば古い形式の名前で配布されたり、 libfoo.dll のような名前で配布されたりすることさえあります。 モジュールの名前に関係なく、LoadModule ディレクティブは正確なファイル名を要求します。 ファイル名の拡張子に関しては何の仮定も行ないません。