モジュール設定

モジュールのサポートは、Openlitespeed 1.3およびLSWS Enterprise 5.0以降で利用できます。 必要なモジュールはすべて、サーバーモジュール設定タブに登録する必要があります。 モジュールファイルは、登録可能なサーバーのroot / modulesフォルダーに置く必要があります。 起動時に、サーバーは登録されているすべてのモジュールをロードします。 新しいモジュールが登録された後、サーバーを再起動する必要があります。 モジュールは、サーバーモジュール設定タブでグローバルに設定できます。 構成データは、リスナーおよびバーチャルホスト・モジュール構成が継承または変更するために使用できます。

目次

サーバーモジュール

モジュール | 内部 | モジュールのパラメータ | フックを有効にする | フック::L4_BEGINSESSION プライオリティ | フック::L4_ENDSESSION プライオリティ | フック::L4_RECVING プライオリティ | フック::L4_SENDING プライオリティ | フック::HTTP_BEGIN プライオリティ | フック::RECV_REQ_HEADER プライオリティ | フック::URI_MAP プライオリティ | フック::HTTP_AUTH プライオリティ | フック::RECV_REQ_BODY プライオリティ | フック::RCVD_REQ_BODY プライオリティ | Hook::RECV_RESP_HEADER Priority | フック::RECV_RESP_BODY プライオリティ | フック::RCVD_RESP_BODY プライオリティ | フック::HANDLER_RESTART プライオリティ | フック::SEND_RESP_HEADER プライオリティ | フック::SEND_RESP_BODY プライオリティ | フック::HTTP_END プライオリティ | フック::MAIN_INITED プライオリティ | フック::MAIN_PREFORK プライオリティ | フック::MAIN_POSTFORK プライオリティ | フック::WORKER_POSTFORK プライオリティ | フック::WORKER_ATEXIT プライオリティ | フック::MAIN_ATEXIT プライオリティ

リスナーモジュール

モジュール | モジュールのパラメータ | フックを有効にする

バーチャルホストモジュール

モジュール | モジュールのパラメータ | フックを有効にする

バーチャルホストモジュールのコンテキスト

URI | モジュールのパラメータ | フックを有効にする

モジュールハンドラコンテキスト

URI | Module | Extra Headers | レルム | 認証名 | 必要(許可ユーザー/グループ) | アクセス許可 | アクセス拒否 | 承認者 | デフォルトの文字セットを追加 | カスタマイズされたデフォルトの文字セット | IPジオロケーションを有効にする

サーバーモジュール

説明

サーバーモジュール構成は、モジュール構成データをグローバルに定義します。 一度定義されると、リスナーとバーチャルホストはモジュールとモジュール構成にアクセスできます。

処理されるすべてのモジュールは、サーバー構成に登録する必要があります。 サーバー構成では、モジュール・パラメーター・データのデフォルト値も定義されています。 これらの値は、リスナーおよびバーチャルホスト構成データによって継承または上書きできます。

モジュールの優先順位は、サーバーレベルでのみ定義され、リスナーとバーチャルホストの設定によって継承されます。

モジュール

説明

モジュールの名前。 モジュール名はモジュールファイル名と同じになります。 モジュール・ファイルは、サーバー・アプリケーションによってロードされるために$SERVER_ROOT/modules/modulename.soの下になければなりません。 サーバーは起動時に登録されたモジュールをロードします。 このためには、新しいモジュールが登録された後でサーバーを再起動する必要があります。

構文

.soのライブラリ名。

内部

説明

モジュールが外部の.soライブラリではなく、静的にリンクされている内部モジュールであるかどうかを指定します。

構文

ラジオボックスから選択

モジュールのパラメータ

説明

モジュールのパラメータを設定します。 モジュールパラメータは、モジュール開発者によって定義されます。

デフォルト値をグローバルに割り当てるようにサーバー構成内の値を設定します。 ユーザーは、この設定をリスナー、バーチャルホストまたはコンテキスト・レベルでオーバーライドできます。 「未設定」ラジオボタンが選択されている場合、それは上位レベルから継承されます。

構文

モジュールインタフェースで指定されます。

フックを有効にする

説明

モジュールフックをグローバルに有効または無効にします。
「未設定」ラジオボタンが選択され、モジュールにフック機能が含まれている場合、デフォルトが有効になります。 ユーザーは、各レベルでこのグローバル設定を上書きできます。

構文

ラジオボックスから選択

フック::L4_BEGINSESSION プライオリティ

説明

このモジュールコールバックの優先度をL4 Begin Session フック内で設定します。
TCP/IP接続が開始されると、L4 Begin Session フックがトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::L4_ENDSESSION プライオリティ

説明

このモジュールコールバックの優先度をL4 End Session フック内で設定します。
TCP/IP接続が終了すると、L4 End Session フックがトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::L4_RECVING プライオリティ

説明

L4 Receiving フック内のこのモジュールコールバックの優先度を設定します。
TCP/IP接続がデータを受信すると、L4 Receiving フックがトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::L4_SENDING プライオリティ

説明

このモジュールコールバックの優先度をL4 Sendingフック内で設定します。
L4_SENDINGフックは、TCP/IP接続がデータを送信するときにトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::HTTP_BEGIN プライオリティ

説明

HTTP Begin フック内のこのモジュールコールバックの優先度を設定します。
TCP/IP接続がHTTPセッションを開始すると、HTTP Begin フックがトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::RECV_REQ_HEADER プライオリティ

説明

HTTP受信要求ヘッダーフック内のこのモジュールコールバックの優先度を設定します。
HTTP受信要求ヘッダーフックは、Webサーバーが要求ヘッダーを受信するとトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::URI_MAP プライオリティ

説明

このモジュールコールバックの優先度をHTTP URIマップフック内で設定します。
HTTP URI マップフックは、WebサーバーがURI要求をコンテキストにマップするときにトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::HTTP_AUTH プライオリティ

説明

HTTP認証フック内のこのモジュールコールバックの優先度を設定します。
HTTP認証フックは、リソースマッピング後およびハンドラ処理の前にトリガされます。 HTTP組み込み認証の後に発生し、追加の認証チェックを実行するために使用できます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::RECV_REQ_BODY プライオリティ

説明

HTTP受信要求ボディフック内のこのモジュールコールバックの優先度を設定します。

Webサーバーが要求本体データを受信すると、HTTP受信要求ボディフックがトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::RCVD_REQ_BODY プライオリティ

説明

HTTP Received Request Body Hook内のこのモジュールコールバックの優先度を設定します。

Webサーバーが要求本体データの受信を終了すると、HTTP受信要求本体フックがトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

Hook::RECV_RESP_HEADER Priority

説明

HTTP受信応答ヘッダーフック内のこのモジュールコールバックの優先度を設定します。

HTTP受信応答ヘッダーフックは、Webサーバーが応答ヘッダーを作成するときにトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::RECV_RESP_BODY プライオリティ

説明

HTTP受信応答ボティフック内のこのモジュールコールバックの優先度を設定します。

HTTP受信応答ボティフックは、Webサーバーのバックエンドが応答本体を受信するとトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::RCVD_RESP_BODY プライオリティ

説明

HTTP受信応答ボディフック内のこのモジュールコールバックの優先度を設定します。

HTTP受信応答ボディフックは、Webサーバーのバックエンドが応答本体の受信を終了するとトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::HANDLER_RESTART プライオリティ

説明

このモジュールコールバックの優先度をHTTPハンドラの再起動フック内で設定します。
Webサーバが現在の応答を破棄し、内部リダイレクトが要求されたときなど、最初から処理を開始する必要があるときに、HTTPハンドラの再起動フックがトリガされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::SEND_RESP_HEADER プライオリティ

説明

このモジュールコールバックの優先度を、HTTP送信応答ヘッダーフック内で設定します。

Webサーバーが応答ヘッダーを送信する準備ができたら、HTTP送信応答ヘッダーフックがトリガーされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::SEND_RESP_BODY プライオリティ

説明

HTTP送信レスポンスボディフック内のこのモジュールコールバックの優先度を設定します。

HTTP送信レスポンスボディフックは、Webサーバがレスポンスボディを送信するときにトリガされます。

モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::HTTP_END プライオリティ

説明

HTTPセッション終了フック内のこのモジュールコールバックの優先度を設定します。

HTTPセッション終了フックは、HTTP接続が終了したときにトリガーされます。
モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::MAIN_INITED プライオリティ

説明

メイン初期化フック内のこのモジュールコールバックの優先度を設定します。

メイン初期化フックは、起動時、メイン(コントローラ)プロセスによってサーバー構成と初期化が完了した後、および要求が処理される前に一度起動されます。
モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先順位はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::MAIN_PREFORK プライオリティ

説明

Main Prefork フック内のこのモジュールコールバックの優先度を設定します。

Main Prefork フックは、新しいワーカープロセスが開始(分岐)される直前にメイン(コントローラ)プロセスによってトリガされます。 これは各ワーカーに呼び出され、システムの起動時やワーカが再起動されたときに発生する可能性があります。
モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::MAIN_POSTFORK プライオリティ

説明

Main Postfork フック内のこのモジュールコールバックの優先度を設定します。

Main Postfork Hookは、新しいワーカープロセスが開始(フォーク)された直後にメイン(コントローラ)プロセスによってトリガされます。 これは各ワーカーに呼び出され、システムの起動時やワーカが再起動されたときに発生する可能性があります。
モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::WORKER_POSTFORK プライオリティ

説明

Worker Postfork Hook内のこのモジュールコールバックの優先度を設定します。

Worker Postfork Hookは、メイン(コントローラ)プロセスによって作成された後、ワーカープロセスによってトリガされます。 対応するMain Postfork Hookは、このコールバックの前または後のメインプロセスによって呼び出されることに注意してください。ck.
モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::WORKER_ATEXIT プライオリティ

説明

このモジュールコールバックの優先度を、終了時のワーカーのフック内で設定します。

退出時のワーカーは、退出する直前のワーカープロセスによってトリガされます。 これは、ワーカーによって呼び出される最後のフックポイントです。
モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

フック::MAIN_ATEXIT プライオリティ

説明

メインの出口フック内のこのモジュールコールバックの優先度を設定します

メインの出口フックは、終了する直前のメイン(コントローラ)プロセスによって起動されます。 これは、メインプロセスによって呼び出される最後のフックポイントです。.
モジュールにフックポイントがある場合にのみ有効です。 設定されていない場合、優先度はモジュールで定義されたデフォルト値になります。

構文

整数値は-6000から6000です。値が小さいほど優先度が高くなります。

リスナーモジュール

説明

リスナーモジュール設定データは、デフォルトでサーバーモジュール設定から継承されます。 リスナモジュールは、TCP / IPレイヤ4フックに限定されています。

フックを有効にする

説明

Listenerレベルでモジュールフックを有効または無効にします。 モジュールにTCP/IPレベルのフック(L4_BEGSESSION、L4_ENDSESSION、L4_RECVING、L4_SENDING)がある場合のみ、この設定が有効になります。

「未設定」ラジオボタンが選択されている場合、デフォルトはServer設定から継承されます。 ユーザーはデフォルト設定を上書きするためにここで設定するだけです。

構文

ラジオボックスから選択

バーチャルホストモジュール

説明

バーチャルホストモジュール構成データは、デフォルトでサーバーモジュール設定から継承されます。 バーチャルホストモジュールはHTTPレベルのフックに制限されています。

フックを有効にする

説明

バーチャルホストまたはコンテキスト・レベルでモジュール・フックを使用可能または使用不可にします。 モジュールにHTTPレベルのフックがある場合のみ、この設定が有効になります。

「未設定」ラジオボタンを選択すると、バーチャルホストレベルのデフォルト設定がサーバー設定から継承されます。 コンテキストレベルの設定は、バーチャルホストレベルから継承されます。 ユーザーはデフォルト設定を上書きするためにここで設定するだけです。

構文

ラジオボックスから選択

バーチャルホストモジュールのコンテキスト

説明

バーチャルホストコンテキストのモジュール設定をカスタマイズするための集中管理された場所です。 コンテキストURIの設定は、バーチャルホストまたはサーバーレベルの設定を上書きします。

URI

説明

このコンテキストのURIを指定します。

構文

URIは、プレーンURI( "/"で始まる)またはPerl互換の正規表現URI( "exp:"で始まる)にすることができます。 プレーンURIが "/"で終わる場合、このコンテキストはこのURIの下にすべてのサブURIを含みます。 コンテキストがファイルシステム上のディレクトリにマップされている場合は、末尾に「/」を追加する必要があります。

参照

ロケーション

モジュールハンドラコンテキスト

説明

モジュールハンドラコンテキストは、登録されたモジュールにURIを関連付けます。 モジュールは[サーバーモジュールの構成]タブに登録する必要があります。

Module

説明

モジュールの名前。 モジュールはサーバーモジュールの設定タブに登録する必要があります。 登録されると、モジュール名がリスナーおよび仮想ホスト構成のドロップダウンボックスで使用可能になります。

構文

ドロップダウンリストから選択

Extra Headers

説明

追加される余分な応答ヘッダーを指定します。 1行に1つのヘッダーを追加できます。 親コンテンツから継承したヘッダーを無効にするには、"NONE"を入力します。

構文

各行に "[HeaderName]: [HeaderValue]"

Cache-control: no-cache, no-store
My-header: Custom header value

レルム

説明

このコンテキストの認可レルムを指定します。 このコンテキストにアクセスするには、有効なユーザー名とパスワードを指定する必要があります。 認可レルムバーチャルホストのセキュリティセクションに設定されています。 この設定では、各レルムのレルム名が使用されます。

構文

選択

認証名

説明

現在のコンテキストの認証レルムの代替名を指定します。 指定しない場合、元のレルム名が使用されます。 認証名は、ブラウザのログインポップアップに表示されます。

構文

テキスト

必要(許可ユーザー/グループ)

説明

このコンテキストにアクセスできるユーザー/グループを指定します。 これにより、複数のコンテキストにわたって1つのユーザー/グループデータベース(レルムで指定)を使用できますが、そのデータベースの特定のユーザー/グループのみがこのコンテキストにアクセスできます。

構文

構文はApache Requireディレクティブと互換性があります。 例えば:

  • user username [username ...]
    リストされたユーザーだけがこのコンテキストにアクセスできます。
  • group groupid [groupid ...]
    リストされたグループに属するユーザーのみがこのコンテキストにアクセスできます。
この設定を指定しないと、すべての有効なユーザーがこのリソースにアクセスできます。

アクセス許可

説明

このコンテキストでリソースにアクセスできるIPまたはサブネットワークを指定します。 アクセス拒否とサーバー/バーチャルホスト・レベルのアクセス制御とともに、アクセシビリティは、クライアントのIPアドレスが入る最小の範囲によって決まります。

構文

IP/サブネットワークのカンマ区切りリスト。

サブネットワークは以下のように書くことができます 192.168.1.0/255.255.255.0, 192.168.1, 又は 192.168.1.*.

アクセス拒否

説明

このコンテキストでリソースにアクセスできないIPまたはサブネットワークを指定します。 アクセス許可とサーバー/バーチャルホストレベルのアクセス制御とともに、アクセシビリティはクライアントのIPアドレスが入る最小の範囲で決まります。

構文

IP/サブネットワークのカンマ区切りリスト。

サブネットワークは以下のように書くことができます 192.168.1.0/255.255.255.0, 192.168.1, 又は 192.168.1.*.

承認者

説明

権限のある/権限のないかの決定を生成するために使用できる外部アプリケーションを指定します。 現在、FastCGI Authorizerのみが使用可能です。 FastCGI Authorizerの役割の詳細については、http://www.fastcgi.comを参照してください。 。

構文

ドロップダウンリストから選択

デフォルトの文字セットを追加

説明

コンテンツタイプが "text/html"または "text/plain"のいずれかのパラメータがない場合、文字セットタグを "Content-Type"レスポンスヘッダーに追加するかどうかを指定します。 Offに設定すると、この機能は無効になります。 Onに設定すると、カスタマイズされたデフォルトの文字セットで指定された文字セットまたはデフォルトの "iso-8859-1"のいずれかが追加されます。

構文

ラジオボックスから選択