Apache Module mod rewrite

概要

mod_rewriteモジュールは、PCRE正規表現パーサーに基づいたルールベースのリライティングエンジンを使用して、要求されたURLを即座に書き換えます。 デフォルトでは、mod_rewriteはURLをファイルシステムのパスにマップします。 ただし、あるURLを別のURLにリダイレクトする場合や、内部プロキシフェッチを呼び出す場合にも使用できます。

mod_rewriteは無制限のルールを使用してURLを操作するための柔軟で強力な方法を提供します。 各ルールには、サーバー変数、環境変数、HTTPヘッダー、またはタイムスタンプに基づいてURLを書き換えることができるように、ルール条件を無制限に追加できます。

mod_rewriteは、path-infoセクションを含む完全なURLパス上で動作します。 書き換えルールは、httpd.confまたは.htaccessで呼び出すことができます。 書き換えルールによって生成されるパスには、クエリ文字列を含めることができます。また、内部サブ処理、外部要求リダイレクト、または内部プロキシスループットにつながる可能性があります。

詳細、議論、および例は、詳細なmod_rewriteのマニュアルに記載されています。

ロギング

mod_rewriteは、trace1〜trace8ログ・レベルでのアクションの詳細なロギングを提供します。 ログレベルは、LogLevelディレクティブを使用してmod_rewrite専用に設定できます。レベルデバッグまで、アクションはログに記録されませんが、trace8は実質的にすべてのアクションが記録されることを意味します。

mod_rewriteに高いトレースログレベルを使用すると、Apache HTTP Serverの速度が大幅に低下します。 デバッグにのみtrace2以上のログレベルを使用してください。

例
LogLevel alert reqrite:trace3

RewriteLog

mod_rewriteの以前のバージョンに精通している人は、間違いなくRewriteLogとRewriteLogLevelディレクティブを探しているでしょう。 この機能は、上記の新しいモジュールごとのログ設定に完全に置き換えられました。

mod_rewrite固有のログメッセージだけを取得するには、ログファイルをgrepを通してパイプします。

tail -f error_log | fgrep 'rewrite:'

RewriteBaseディレクティブ

説明：ディレクトリごとの書き換えのベースURLを設定します。

構文：RewriteBase URLパス

デフォルト：なし

コンテキスト：Directory、.htaccess

上書き：FileInfo

ステータス：拡張機能

モジュール：mod_rewrite

RewriteBaseディレクティブは、相対パスで置き換えられるディレクトリ単位（htaccess）のRewriteRuleディレクティブに使用されるURLプレフィックスを指定します。

このディレクティブは、次の条件のいずれかが当てはまる場合を除いて、ディレクトリ単位（htaccess）コンテキストの置換で相対パスを使用する場合に必要です。

• 元の要求と置換は、DocumentRootの下にあります（別名などの別の手段で到達可能ではありません）。
• RewriteRuleを含むディレクトリへのファイルシステムパスには、相対置換の接尾辞が付いています。これは、サーバー上のURLパスとしても有効です（これはまれです）。
• Apache HTTP Server 2.4.16以降では、リクエストが別名またはmod_userdirを使用してマップされている場合、このディレクティブは省略できます。

次の例では、リソースがドキュメントルートからの相対パスではないため、RewriteBaseはhttp://example.com/opt/myapp-1.2.3/welcome.htmlへの書き換えを避けるために必要です。この設定ミスにより、通常、サーバはドキュメントルートの下に "opt"ディレクトリを探すでしょう。

DocumentRoot "/var/www/example.com" AliasMatch "^ / myapp" "/opt/myapp-1.2.3" <ディレクトリ "/opt/myapp-1.2.3">

   RewriteEngineをオンにする
   RewriteBase "/ myapp /"
   RewriteRule "^ index \ .html $" "welcome.html"

</ Directory>