OpenLiteSpeed Web Server ユーザーズマニュアル

Version 1.4 Rev. 2

Rewrite

目次

Rewrite制御

Rewriteを有効にする | ログレベル | 

Rewriteマップ

名前 | ロケーション | 

Rewriteルール

Rewriteルール | 

Rewriteを有効にするGo to top

説明

LiteSpeedのURL書き換えエンジンを有効にするかどうかを指定します。 このオプションは、バーチャルホストまたはコンテキストレベルでカスタマイズでき、明示的に上書きされるまでディレクトリツリーに沿って継承されます。

構文

ラジオボックスから選択

ログレベルGo to top

説明

書き換えエンジンのデバッグ出力の詳細レベルを指定します。 この値の範囲は0-9です。0はロギングを無効にします。9は最も詳細なログを生成します。 このオプションを有効にするには、サーバーとバーチャルホストのエラーログログレベルを少なくともINFO以上に設定する必要があります。 これは、書き換えルールをテストする場合に便利です。

構文

整数

参照

Server ログレベル, Virtual Host ログレベル

名前Go to top

説明

バーチャルホスト・レベルでの再書き込みマップの一意の名前を指定します。 この名前は、書き換えルールのマッピング参照によって使用されます。 この名前を参照するときは、次の構文のいずれかを使用する必要があります:

$\{MapName:LookupKey\}
$\{MapName:LookupKey|DefaultValue\}

LiteSpeedのリライトエンジンの実装は、Apacheのリライトエンジンの仕様に準拠しています。 書き直しマップの詳細については、Apacheのmod_rewrite文書を参照してください。

構文

文字列

ロケーションGo to top

説明

MapType:MapSource構文を使用して、書き換えマップの場所を指定します。
LiteSpeedの書き換えエンジンは、次の3種類の書き換えマップをサポートしています:

  • 標準プレーンテキスト
    MapType: txt;
    MapSource: ファイルパスを有効なプレーンASCIIファイルに変換します。
    このファイルの各行には空白で区切られた2つの要素が含まれていなければなりません。 最初の要素はキーで、2番目の要素は値です。 コメントには先頭に「#」という記号を付けることができます。
  • ランダム化されたプレーンテキスト
    MapType: rnd;
    MapSource: 有効なプレーンASCIIファイルのファイルパス。
    ファイル形式は、標準のプレーンテキストファイルと似ていますが、2番目の要素には " | "記号で区切られた 複数の選択肢があり、書き換えエンジンによってランダムに選択できます。
  • 内部機能
    MapType: int;
    MapSource: 内部文字列関数
    4つの機能を利用できます:
    • toupper: 検索キーを大文字に変換します。
    • tolower: 検索キーを小文字に変換します。
    • escape: 検索キーでURLエンコーディングを実行します。
    • unescape: 検索キーでURLデコードを実行します。
  • Apacheで利用可能な次のマップタイプはLiteSpeedでは実装されていません:
    ハッシュファイルと外部書き換えプログラム。
LiteSpeedのリライトエンジンの実装は、Apacheのリライトエンジンの仕様に準拠しています。 書き直しマップの詳細については、Apacheのmod_rewrite文書を参照してください。

構文

文字列

RewriteルールGo to top

説明

バーチャルホストまたはコンテキスト・レベルでの書き換えルールのリストを指定します。 書き換えルールは、RewriteRuleディレクティブから構成され、オプションとして複数のRewriteCondディレクティブが前に付いています。

  • 各ディレクティブは1行だけを取る必要があります。
  • RewriteCondRewriteRuleは、Apacheのリライト命令構文に従います。 あなたのApache設定ファイルから書き換え命令文をコピー&ペーストするだけです。
  • LiteSpeedとApache mod_rewriteには小さな違いがあります 実装:
       
    • LiteSpeed書き換えエンジンでは、%\ {LA-U:変数\} %\ {LA-F:変数\} は無視されます
    • LiteSpeed書き換えエンジンに2つの新しいサーバー変数が追加されました。: LiteSpeed書き換えエンジンに2つの新しいサーバー変数が追加されました。 %\{CURRENT_URI\}は、書き換えエンジンによって処理されている現在のURIを表し、%\{SCRIPT_NAME\}は対応するCGI環境変数と同じ意味を持ちます。
LiteSpeedのリライトエンジンの実装は、Apacheのリライトエンジンの仕様に従います。 書き換えルールの詳細については、Apacheのmod_rewriteドキュメントApacheのURL書き換えガイドを参照してください。

構文

文字列