警告

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 はそのまま配布することが可能で、サーバを再コンパイルすることなく、Windows 用の Apache httpd のすべてのインストールで実行することができます。

モジュール DLL を作成するためには、モジュールの作成に小さな変更を行なう必要があります。つまり、モジュールのレコード (これは後で作成されます。以下を参照してください) が DLL からエクスポートされなければなりません。これを行なうには、AP_DECLARE_MODULE (Apache httpd のヘッダファイルで定義されています) をモジュールのモジュールレコード定義の部分に追加してください。たとえば、モジュールに

module foo_module;

があるとすると、それを次のもので置き換えてください。

AP_DECLARE_MODULE(foo);

Unix 上でもこのモジュールを変更無しで使い続けられるように、このマクロは Windows 上でのみ効力を持ちます。.DEF ファイルの方を良く知っているという場合は、代わりにそれを使ってモジュールレコードをエクスポートすることもできます。

さあ、あなたのモジュールの DLL を作成しましょう。これを、 libhttpd.lib 共有ライブラリがコンパイルされたときに作成された ibhttpd.lib エクスポートライブラリとリンクしてください。この時に、 Apache httpd のヘッダファイルが正しい位置にあるように、コンパイラの設定を変える必要があるかもしれません。このライブラリはサーバルートの modules ディレクトリにあります。ビルド環境が正しく設定されるように、既存のモジュール用の .dsp を取ってくるのが一番良いでしょう。もしくは、あなたの .dsp とコンパイラとリンクのオプションを比較する、というものでも良いです。

これで DLL 版のモジュールが作成されているはずです。サーバルートの modules ディレクトリにモジュールを置いて、 LoadModule ディレクティブを使って読み込んでください。