Rewriteモジュールの使用(.htaccess)

Rewriteモジュールを有効化するには.htaccessに以下のように記述する。

# .htaccessでRewriteを有効化する
RewriteEngine On
RewriteBase /

Rewriteモジュールを有効化したら、あとは次に述べるRewriteRuleおよびRewriteCondを使用してURL書き換えの条件・ルールを記述することで、実際のURL書き換え等が行われる。なお、RewriteEngine Offとすると他に記述した全てのRewrite関連ディレクティブが無効となる(無視される)。RewriteBaseは書き換えのベースとなるパスを指定するディレクティブで、ベースパスが自明である場合は記述しなくても良い。

RewriteRule(URL書き換え＆リダイレクト)

URL書き換えを行うルールを記述する。これがRewriteモジュールのメインのディレクティブである。リクエストされたURLのパスが条件に一致した場合、指定したURLの書き換えを行う。

RewriteEngine On
RewriteBase /
# 書式：RewriteRule パターン 置換対象 オプション
# /virtualpath/* へのリクエストがあった場合 /realpath/*の内容を返す
RewriteRule virtualpath/(.*) realpath/$1 
# /images/* へのリクエストがあった場合 
# http://www.dawgsdk.org/images/*にリダイレクト
RewriteRule images/(.*) http://www.dawgsdk.org/images/$1 [R,L]
# 特定のサブディレクトリへのリクエストを
# 全てindex.phpにPATH_INFOとして渡して処理する
RewriteRule (test|read)(.*) index.php/$1$2

パターンは通常の正規表現を用いて記述し、置換対象の記述では後方参照を使用することができる。RewriteRuleの末尾に[ ]でオプションを付加することでルールの適用条件やマッチした場合に行う処理を変更することができる。設定可能なオプションには以下のようなものがある。

RewriteによるURL書き換えは[R]オプションを指定してリダイレクトする場合を除き、すべてサーバー内部で処理されるため、表にその痕跡は一切現れず、クライント側からは書き換えが行われたことを知ることは出来ない。

RewriteCond(環境変数などに応じた条件付加)

環境変数やその他の条件に応じた判定を付加する。これを記述すると条件にマッチした場合のみ次に現れるRewriteRuleが評価される。

RewriteEngine On
RewriteBase /
# 書式：RewriteCond テスト文字列 条件パターン オプション  
# ---- 例1：携帯端末からのアクセスを振り分ける(DoCoMo,J-Phone,ezweb)
RewriteCond %{HTTP_USER_AGENT} DoCoMo [OR]
RewriteCond %{HTTP_USER_AGENT} J-PHONE [OR]
RewriteCond %{HTTP_USER_AGENT} UP\.Browser
RewriteRule ^/$ i/index.html [L]
# ---- 例2：同一ルートに割り当てられたバーチャルサブドメインの振り分け
RewriteCond %{HTTP_HOST} domain1\.dawgsdk\.org
RewriteCond %{REQUEST_URI} !^domain1/.*
RewriteRule /(.*) domain1/$1 [L]
RewriteCond %{HTTP_HOST} domain2\.dawgsdk\.org
RewriteCond %{REQUEST_URI} !^domain2/.*
RewriteRule /(.*) domain2/$1 [L]
# ---- 例3：ファイルが存在する場合にはURL書き換え
RewriteCond /~user/next.html -f
RewriteRule index.html next.html [L]

上記の例1,2にあるようにテスト文字列で環境変数等を用いるには %{変数名}と記述する。利用可能な変数には下記のようなものがある。

条件パターンの記述では通常の拡張正規表現のほか、上記の例3のように特殊なパターンが使用可能。特殊パターンは下記の通り。

オプションには次の二つがある。