.htaccessで使える正規表現・環境変数・mod_rewriteについて

2021年12月1日 2023年10月1日

.htaccessの中で使える正規表現や環境変数、mod_rewriteについて、備忘録も兼ねてまとめました。

mod_rewriteとモジュールの意味

mod_rewriteとは、Apacheというサーバで利用されているURLの書き換え・リダイレクト処理を行うモジュールです。
「.htaccess」で記述して使用できます。

mod_rewriteモジュールには、

などがあります。

RewriteEngine on でこれからURLのリダイレクトを行うことを示します。

URLリダイレクトを行う条件を指定します。

RewriteCond %{HTTPS} off

（HTTPS通信ではない場合）

合致するURLと転送先を指定します。

RewriteRule ^(.*)$ https://（新URL）/$1 [R=301,L]

どんなURLでも、https://（新URL）に301リダイレクトします。

RewriteBase /

リライト処理のベースとなるURLを指定します。
これがない場合は.htaccessがあるディレクトリになります。
「RewriteBase /」と記述しておくとルートからのパスになります、わかりやすくなるのでおすすめです。

mod_rewriteモジュールを使用する場合は
使用するコードを以下のように<IfModule mod_rewrite.c>〜</IfModule>で囲みます。

<IfModule mod_rewrite.c>
・・・
ここにリライトモジュールを記載する
・・・
</IfModule>

mod_rewrite内では正規表現が使うことができます。
よく使うものは以下の通りです。

RewriteRuleの最後にフラグ[]を追記することができます。

RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]

R=301	RはリダイレクトのR 「R=301」とすると、301リダイレクトを指定する。
L	LastのL L が指定されている RewriteRule の条件にマッチした場合、以降のRewriteRuleを処理しない。ただし.htaccessではLフラグが有効にならないので、つけても意味はない。
NC	大文字小文字を区別しない（指定しなかった場合は区別する）

RewriteCond %変数名 条件① [OR,NC]
RewriteCond %変数名 条件②
RewriteRule URL書換＆転送の記述

条件①と条件②いずれかを満たす場合、リダイレクトを行う。

RewriteCond %変数名 条件①
RewriteCond %変数名 条件②
RewriteRule URL書換＆転送の記述

[OR]フラグを記載せず、2行続けてRewriteCondを記載する場合、条件①と条件②の両方を満たす場合リダイレクトを行う。

RewriteCondでのパーセント記号（%）は、環境変数を表します。
{}の中に接続してきたブラウザなどの情報から、環境変数名を読み込んで使用することができます。

RewriteCond %{HTTP:X-Forwarded-Proto} !https

%{HTTP:X-Forwarded-Proto}　＝　HTTPヘッダを取得する

その他の環境変数は以下の通りです。