「Apache mod rewriteメモ」の版間の差分

2018年3月20日 (火) 20:35時点における最新版

mod_rewrite

ロギング

httpd.confに追加

LogLevel alert rewrite:trace4

ログはerror.logに吐かれる。

sed -e 's/^\(.*\)\(\[perdir.*\)$/\2/'

RewriteBaseとは

書式

RewriteBase URL上のディレクトリパス

説明

DocumentRoot

/var/www/site/

htmlの配置

/var/www/site/abc/hoge.html
/var/www/site/abc/piyo.html

ルール

RewriteEngine On
RewriteBase /abc
RewriteRule ^abc/hoge\.html piyo.html [L]

例： URLをhttp://server/abc/hoge.htmlと指定した場合、表示されているURLはそのままで、${DOCUMENT_ROOT}${REWRITE_BASE}/piyo.htmlの内容が表示される。
この場合、URL表示はhttp://server/abc/hoge.htmlで、実際には/var/www/site/abc/piyo.htmlが表示される。

Rewriteのメカニズム

Aliasがない場合

httpd.conf

DocumentRoot /var/www/html

/var/www/html/ore/sandbox/.htaccess

RewriteEngine On
 
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]

RewriteRule ^.*$ index.php [NC,L]

リクエストパス：http://example.com/ore/sandbox/aaa/zzz

URLのパス部分： ore/sandbox/aaa/zzz

mod_rewriteには、${DocumentRoot}+${URLのパス}が渡される：
- /var/www/html/ore/sandbox/aaa/zzz
.htaccessのあるディレクトリまでのパスを削除
- /var/www/html/ore/sandbox/aaa/zzz -> aaa/zzz
RewriteRule条件のチェック
- ^.*$なのでマッチ
パスの書き換え
- aaa/zzz -> index.php
2. で除去したパスをくっつける。
- index.php -> /var/www/html/ore/sandbox/index.php
ドキュメントルートを削除
- /var/www/html/ore/sandbox/index.php -> /ore/sandbox/index.php
書き換えられたパスに内部リダイレクト
- /ore/sandbox/index.php

Aliasを使った時

httpd.conf

DocumentRoot /var/www/html
Alias /ore/sandbox /home/ore/sandbox/html

/home/ore/sandbox/.htaccess

RewriteEngine On
 
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]

RewriteRule ^.*$ index.php [NC,L]

リクエストパス：http://example.com/ore/sandbox/aaa/zzz

URLのパス部分： ore/sandbox/aaa/zzz

mod_rewriteには、${Aliasで指定したパス}+${URLのパス}が渡される：
- /home/ore/sandbox/html/aaa/zzz
.htaccessのあるディレクトリまでのパスを削除
- /home/ore/sandbox/html/aaa/zzz -> aaa/zzz
RewriteRule条件のチェック
- ^.*$なのでマッチ
パスの書き換え
- aaa/zzz -> index.php
2. で除去したパスをくっつける。
- index.php -> /home/ore/sandbox/html/index.php
ドキュメントルートを削除
- /home/ore/sandbox/html/index.php -> /home/ore/sandbox/html/index.php
  - ところが、パスのプレフィックスが違うために取り除けない。
書き換えられたパスに内部リダイレクト
- /home/ore/sandbox/html/index.php
  - しかしながら、http://example.com/home/ore/sandbox/html/index.phpというパスは存在しないため、404 Not Foundを返す。

RewriteRuleとは

書式

RewriteRule 置換前のパターン 置換後の文字列

置換前のパターン：リクエストされたURLとは限らず、書き換えされてきたURLも指す。

説明

DocumentRoot

/var/www/site/

htmlの配置

/var/www/site/hoge.html
/var/www/site/piyo.html

ルール

RewriteEngine On
RewriteRule ^/?hoge\.html$ piyo.html [L]

^/?hoge\.html$：渡ってきたURL（正規表現）をpiyo.htmlで置換。[L]はここで書き換えを終了するという意味。

URLがhoge.htmlと渡ってくるか、/hoge.htmlと渡ってくるかの違い
- <VirtualHost>ディレクティブの場合は、URLのパスが対象となり、先頭に/が付く
- `Directory`ディレクティブや`.htaccess`の場合は、そのディレクトリからの相対パスが対象となり、先頭に`/`が付かない。

(.*)パターンをグループ化

RewriteEngine On
RewriteRule (.*) http://server/$1 [R]

(.*)を変数$1で展開

http://server1/hoge.html -> http://server/hoge.html

RewriteEngine ON
RewriteRule ^/旧ディレクトリ/(.*) /新ディレクトリ/$1

RewriteEngine On
RewriteRule ^(/somedir/.*) http://newserver/$1 [R]

RwriteRuleのフラグ

RewriteRuleのフラグ
フラグ	意味	説明
C	Chain	このルールにマッチしたら、次のルールを評価
F	Forbidden	アクセス禁止（403-Forbidden）。[L]フラグと同様、以降のルールは無視。
G	Gone	削除（410-GOne)
L	Last	マッチしたらRewriteを辞めます。以降のルールは無視。
NC	No Case	大文字小文字を無視
NE	No Escape	"."、"？"、"%"などの特殊文字が"%25"のようにエンコードされるのを防ぐ
OR	Or	RewriteCondを複数指定する場合のOr指定。指定なしならAND
PT	Path Through	Rewriteを終了し、それ以外の処理に移行
R	Redirect	指定したURLにリダイレクト。[R=303]のようにリダイレクトコードも付加できる。[L]同様、以降のルールは無視。

@@ 1行目: / 1行目: @@
+== mod_rewrite ==
+=== ロギング ===
+<code>httpd.conf</code>に追加
+ LogLevel alert rewrite:trace4
+ログは<code>error.log</code>に吐かれる。
+ sed -e 's/^\(.*\)\(\[perdir.*\)$/\2/'
 == RewriteBaseとは ==
@@ 28行目: / 40行目: @@
 === Rewriteのメカニズム ===
+==== Aliasがない場合 ====
 '''httpd.conf'''
@@ 55行目: / 69行目: @@
 # パスの書き換え
 #* <code>'''<span style="color:red;">aaa/zzz</span>'''</code> -> <code>'''index.php'''</code>
+# 2. で除去したパスをくっつける。
+#* <code>'''index.php'''</code> -> <code>'''<span style="color:blue;">/var/www/html/ore/sandbox/</span>index.php'''</code>
+# ドキュメントルートを削除
+#* <code>'''<span style="color:red;">/var/www/html/</span>ore/sandbox/index.php'''</code> -> <code>'''/ore/sandbox/index.php'''</code>
+# 書き換えられたパスに内部リダイレクト
+#* <code>'''/ore/sandbox/index.php'''</code>
+==== Aliasを使った時 ====
+'''httpd.conf'''
+ DocumentRoot '''/var/www/html'''
+ Alias '''/ore/sandbox''' '''/home/ore/sandbox/html'''
+'''/home/ore/sandbox/.htaccess'''
+ RewriteEngine On
+ RewriteCond %{REQUEST_FILENAME} -s [OR]
+ RewriteCond %{REQUEST_FILENAME} -l [OR]
+ RewriteCond %{REQUEST_FILENAME} -d
+ RewriteRule ^.*$ - [NC,L]
+ RewriteRule ^.*$ index.php [NC,L]
+'''リクエストパス：<nowiki>http://example.com/ore/sandbox/aaa/zzz</nowiki>'''
+:* URLのパス部分： '''ore/sandbox/aaa/zzz'''
+# <code>mod_rewrite</code>には、<code>${Aliasで指定したパス}+${URLのパス}</code>が渡される：
+#* <code>'''/home/ore/sandbox/html/aaa/zzz'''</code>
+# <code>.htaccess</code>のあるディレクトリまでのパスを削除
+#* <code>'''<span style="color:red;">/home/ore/sandbox/html/</span>aaa/zzz'''</code> -> <code>'''aaa/zzz'''</code>
+# <code>RewriteRule</code>条件のチェック
+#* <code>^.*$</code>なのでマッチ
+# パスの書き換え
+#* <code>'''<span style="color:red;">aaa/zzz</span>'''</code> -> <code>'''index.php'''</code>
+# 2. で除去したパスをくっつける。
+#* <code>'''index.php'''</code> -> <code>'''<span style="color:blue;">/home/ore/sandbox/html/</span>index.php'''</code>
+# ドキュメントルートを削除
+#* <code>'''/home/ore/sandbox/html/index.php'''</code> -> <code>'''<span style="color:red">/home/ore/sandbox/html/index.php</span>'''</code>
+#** ところが、パスのプレフィックスが違うために取り除けない。
+# 書き換えられたパスに内部リダイレクト
+#* <code>'''/home/ore/sandbox/html/index.php'''</code>
+#** しかしながら、<code>'''<nowiki>http://example.com/home/ore/sandbox/html/index.php</nowiki>'''</code>というパスは存在しないため、<code>'''404 Not Found'''</code>を返す。
 == RewriteRuleとは ==