Apacheで学ぶ！mod_rewriteを使った基本的なURLリライト設定方法

Apacheのmod_rewriteは、Webサーバー上でURLの書き換えを行うための非常に強力なモジュールです。美しいURLや、SEOに適したリンク構造を作成するために利用されます。また、旧URLから新URLへのリダイレクトや、アクセス制限など、柔軟なルールを定義できる点が特徴です。

本記事では、mod_rewriteの基本的な仕組みや導入方法をわかりやすく解説します。さらに、具体的な設定例を交えながら、実際にどのようにURLを書き換えるのかを学びます。特に初心者の方がつまずきやすいポイントを解説し、mod_rewriteを使いこなせるようになることを目指します。

Apacheを利用してWebサイトを運営している方、URL構造を改善したい方はぜひ参考にしてください。

mod_rewriteとは？
1. mod_rewriteの役割と利点
2. mod_rewriteの実例
mod_rewriteの基本的な使い方
URLリライトの基礎ルール解説
よく使うURLリライトの例
クエリストリングの書き換え方法
リライトループの回避方法
トラブルシューティングとデバッグ方法
リライトルールの応用例
まとめ

mod_rewriteとは？

mod_rewriteは、Apache Webサーバーで使用されるモジュールで、URLの書き換えやリダイレクトを柔軟に行うことができます。これは、特定のパターンに一致するURLを別のURLに変換するためのルールを設定できる強力なツールです。

mod_rewriteの役割と利点

mod_rewriteの主な役割は、ユーザーがアクセスするURLをサーバー内部で処理し、任意のURLに変換することです。これにより、以下のような利点があります。

SEOの向上：クリーンでわかりやすいURLは検索エンジンに好まれ、サイトの評価が向上します。
ユーザビリティの向上：長く複雑なURLを短く簡潔にすることで、ユーザーが覚えやすくなります。
セキュリティ強化：URL構造を隠蔽することで、サーバー構成を外部から見えにくくできます。
サイト移行時のURL保持：サイト構成を変更しても、旧URLから新URLへのリダイレクトが簡単に設定できます。

mod_rewriteの実例

たとえば、次のような複雑なURL：

https://example.com/index.php?page=about

これを以下のようなシンプルなURLに変換できます。

https://example.com/about

これにより、ユーザーはより直感的に目的のページへアクセスできます。

mod_rewriteは、こうした柔軟なURL変換を実現するための不可欠なツールとして、多くのWebサイトで活用されています。

mod_rewriteの基本的な使い方

mod_rewriteを使用するには、まずApacheでモジュールを有効化し、適切な設定ファイルにルールを記述する必要があります。以下では、mod_rewriteを有効にし、簡単なリライトルールを設定する手順を解説します。

mod_rewriteの有効化

Apacheのモジュールを確認する
まず、mod_rewriteがインストールされているかを確認します。以下のコマンドを実行してください。

apachectl -M | grep rewrite

rewrite_module (shared)と表示されれば、有効化されています。

mod_rewriteを有効化する
もし無効の場合は、以下のコマンドで有効化します。

sudo a2enmod rewrite
sudo systemctl restart apache2

これでmod_rewriteが有効になります。

.htaccessファイルの作成

mod_rewriteのルールは、主に.htaccessファイルに記述します。これは、Apacheがディレクトリごとに適用する設定ファイルです。

.htaccessファイルを作成
対象のディレクトリに移動し、以下のコマンドで.htaccessファイルを作成します。

touch .htaccess

Apacheの設定ファイルを編集
/etc/apache2/sites-available/000-default.confなどの設定ファイルを編集し、AllowOverrideをAllに変更します。

<Directory /var/www/html>
    AllowOverride All
</Directory>

変更後、Apacheを再起動します。

sudo systemctl restart apache2

簡単なリライトルールの例

以下は、URLのexample.com/aboutをexample.com/index.php?page=aboutにリライトする例です。

RewriteEngine On
RewriteRule ^about$ index.php?page=about [L]

これにより、/aboutにアクセスした際に、内部でindex.php?page=aboutが呼び出されます。

このように、mod_rewriteの基本設定はシンプルですが、強力なリライトが可能です。次のセクションでは、具体的なルールの構文について詳しく説明します。

URLリライトの基礎ルール解説

mod_rewriteでURLを書き換える際は、RewriteRuleやRewriteCondを使用してルールを定義します。ここでは、基本的な構文とフラグの使い方について解説します。

RewriteRuleの基本構文

RewriteRuleは、URLのリライトを行うための最も基本的なディレクティブです。以下のような形式で記述します。

RewriteRule パターン 置換 [フラグ]

パターン：書き換え対象となるURLのパターンを正規表現で記述します。
置換：一致したパターンをどのURLに置き換えるかを指定します。
フラグ：ルールの動作を制御するオプションです（例：リダイレクト、ループ防止など）。

RewriteRuleの例

以下は、example.com/aboutへのアクセスをexample.com/index.php?page=aboutにリライトする例です。

RewriteEngine On
RewriteRule ^about$ index.php?page=about [L]

^about$：aboutというURLパスに完全一致するパターンです。
index.php?page=about：アクセスが内部でindex.php?page=aboutに置き換えられます。
[L]：このルールが適用されたら、他のルールを無視して処理を終了します。

RewriteCondの使用

RewriteCondは、RewriteRuleに条件を加えるためのディレクティブです。複数の条件を記述することで、特定の状況でのみリライトルールを適用できます。

例：HTTPSを強制するルール

RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]

%{HTTPS} !=on：HTTPSではない場合にルールを適用します。
R=301：リダイレクトを行い、HTTPステータスコード301（恒久的リダイレクト）を返します。

フラグの一覧と役割

[L]：最後のルール。これ以降のルールは適用されません。
[R=301]：リダイレクトし、ステータスコードを301に指定します。
[NC]：大文字小文字を区別しません。
[QSA]：クエリストリングを引き継ぎます。
[F]：403 Forbiddenを返します。
[P]：プロキシとして振る舞います。

これらのルールとフラグを組み合わせることで、柔軟なURLリライトが可能になります。次のセクションでは、実際によく使われるリライト例を紹介します。

よく使うURLリライトの例

mod_rewriteは、サイト運営で頻繁に使われるURLのリライトやリダイレクトを簡単に実装できます。ここでは、実際によく使われるリライトルールの具体例を紹介します。

1. wwwの追加・削除

wwwを強制的に付与するルール

RewriteEngine On
RewriteCond %{HTTP_HOST} ^example.com [NC]
RewriteRule ^(.*)$ http://www.example.com/$1 [L,R=301]

説明：example.comへのアクセスをwww.example.comにリダイレクトします。
[NC]：大文字小文字を区別しません。
[R=301]：恒久的なリダイレクトを行います。

wwwを削除するルール

RewriteEngine On
RewriteCond %{HTTP_HOST} ^www\.(.*)$ [NC]
RewriteRule ^(.*)$ http://%1/$1 [L,R=301]

説明：www.example.comをexample.comにリダイレクトします。

2. HTTPSへの強制リダイレクト

サイト全体をHTTPSに強制するリダイレクトルールです。

RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]

説明：HTTPSが有効でない場合に、HTTPSへリダイレクトします。

3. トレーリングスラッシュの付与・削除

スラッシュを強制的に追加するルール

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_URI} !/$
RewriteRule ^(.*)$ $1/ [L,R=301]

説明：ディレクトリにアクセスする際、自動的に末尾にスラッシュを追加します。

スラッシュを削除するルール

RewriteEngine On
RewriteRule ^(.+)/$ $1 [R=301,L]

説明：URLの末尾にスラッシュがある場合、それを削除します。

4. カスタム404ページへのリダイレクト

存在しないページへのアクセスをカスタムの404エラーページにリダイレクトします。

ErrorDocument 404 /custom404.html

説明：404エラーが発生した際に、custom404.htmlを表示します。

5. 特定の拡張子を除外する

特定のファイルをリライトの対象外にするルールです。

RewriteEngine On
RewriteCond %{REQUEST_URI} !\.(jpg|png|css|js)$ [NC]
RewriteRule ^(.*)$ index.php?page=$1 [L]

説明：画像やスタイルシートなどを除外し、他のURLはindex.phpで処理します。

これらのルールを使えば、サイトのURL構造を自由にカスタマイズし、ユーザビリティやSEOの向上が期待できます。次のセクションでは、さらに高度なリライトルールの書き方を紹介します。

クエリストリングの書き換え方法

mod_rewriteでは、URLのパスだけでなく、クエリストリング（?key=value形式）も書き換えることが可能です。特定のパラメータを追加・変更したり、クエリストリングを含むURLをリダイレクトすることで、より柔軟なURL管理ができます。

クエリストリングの基本的なリライト

URLパスの一部としてクエリストリングを付与するルールの例を示します。

RewriteEngine On
RewriteRule ^product/([0-9]+)$ product.php?id=$1 [L]

説明：/product/123 のようなURLを product.php?id=123 にリライトします。
([0-9]+)：数字が1回以上続くパターンにマッチします。
$1：正規表現のキャプチャグループを参照し、マッチした値をURLに挿入します。

既存のクエリストリングを維持する方法

リライト後も元のクエリストリングを保持するには、[QSA]（Query String Append）フラグを使用します。

RewriteEngine On
RewriteRule ^search/(.*)$ search.php?query=$1 [QSA,L]

例：/search/books を search.php?query=books にリライトし、元のクエリストリングも保持します。
QSA：既存のクエリストリングがある場合、追加してリクエストします。

特定のクエリストリングをリライトする

既存のクエリストリングを条件にして書き換えることもできます。

RewriteEngine On
RewriteCond %{QUERY_STRING} ^category=shoes$
RewriteRule ^shop$ shop/shoes [L]

説明：shop?category=shoes へのアクセスを shop/shoes にリダイレクトします。
%{QUERY_STRING}：現在のクエリストリングを条件として参照します。

クエリストリングを削除するルール

不要なクエリストリングを削除してクリーンなURLに変換する場合は、? を使ってクエリストリングをリセットします。

RewriteEngine On
RewriteRule ^archive/(.*)$ /new-archive/$1? [R=301,L]

説明：/archive/2024?page=2 を /new-archive/2024 にリダイレクトし、クエリストリングを削除します。
?：クエリストリングを空にします。

クエリストリングの一部を書き換える

クエリの特定部分を変更する場合は、条件と置換を組み合わせます。

RewriteEngine On
RewriteCond %{QUERY_STRING} ^type=old$
RewriteRule ^items$ items?type=new [L]

説明：items?type=old へのアクセスを items?type=new に変更します。

クエリストリングの書き換えは、特定のURLパターンへの誘導やリダイレクト時の利便性向上に役立ちます。適切にルールを設定することで、ユーザー体験の向上やサイトの整理が可能になります。

リライトループの回避方法

mod_rewriteでURLを書き換える際、リライトループが発生すると無限ループ状態になり、サーバーがエラーを返すことがあります。これは、リライトルールが意図せず繰り返し適用されることが原因です。ここでは、リライトループの原因と、それを防ぐ方法について解説します。

リライトループの原因

リライトループは、以下のようなケースで発生します。

同じパターンが繰り返しマッチする

   RewriteEngine On
   RewriteRule ^(.*)$ /index.php [L]

/index.phpにリライトされた後、再度ルールが適用され続けるため、無限ループになります。

リダイレクト先が再度リライト対象になる

   RewriteEngine On
   RewriteRule ^about$ /about-us [R=301,L]
   RewriteRule ^about-us$ /about [R=301,L]

aboutがabout-usにリダイレクトされた後、about-usが再度aboutに戻されてしまいます。

リライトループを回避する方法

1. `RewriteCond`でリダイレクト対象を除外する

条件を追加して、すでにリライトされたURLにはルールが適用されないようにします。

RewriteEngine On
RewriteCond %{REQUEST_URI} !^/index.php$
RewriteRule ^(.*)$ /index.php [L]

説明：REQUEST_URIが/index.phpでない場合にのみ、リライトが適用されます。

2. フラグ `[L]` を適切に使用する

[L]（Last）フラグは、マッチしたルールの適用後にそれ以上のルールが適用されないことを示します。

RewriteEngine On
RewriteRule ^about$ /about-us [R=301,L]
RewriteRule ^about-us$ /info [L]

説明：最初のルールが適用された後、それ以上のルールが適用されません。

3. 環境変数を使ったループ回避

環境変数を使って、一度適用されたリライトを繰り返さないようにします。

RewriteEngine On
RewriteCond %{ENV:REDIRECT_STATUS} ^$
RewriteRule ^(.*)$ /index.php [L]

説明：リダイレクトが発生していない場合（REDIRECT_STATUSが空の場合）にのみルールが適用されます。

4. スラッシュを利用したパターン設計

リライト対象とリダイレクト先を区別するために、スラッシュを使って回避する方法です。

RewriteEngine On
RewriteRule ^old/(.*)$ /new/$1 [R=301,L]
RewriteRule ^new/(.*)$ /index.php?page=$1 [L]

説明：oldディレクトリのリクエストはnewディレクトリへ、それ以降はindex.phpにリダイレクトします。

リライトループが発生した際の確認方法

エラーログの確認
Apacheのエラーログを確認して、どのURLでループが発生しているかを特定します。

sudo tail -f /var/log/apache2/error.log

ブラウザのデベロッパーツール
ブラウザのネットワークタブでリダイレクトの状態を確認し、ループの原因となるURLを特定します。

リライトループは、サーバーの負荷を増加させ、ユーザー体験を損なう原因になります。適切にルールを設計し、必要に応じて条件を付与することで、安定したリライト設定が可能になります。

トラブルシューティングとデバッグ方法

mod_rewriteを使ったURLリライトは強力ですが、意図した通りに動作しないことがあります。リライトがうまく機能しない場合や、予期せぬ結果が発生する場合には、適切なトラブルシューティングが必要です。ここでは、mod_rewriteのデバッグ方法と問題解決の手順を解説します。

1. Apacheのエラーログを確認する

mod_rewriteの動作エラーやリライトループなどは、Apacheのエラーログに記録されます。ログを確認することで問題の原因を特定できます。

sudo tail -f /var/log/apache2/error.log

確認ポイント：
無限ループの兆候（繰り返し同じURLが表示される）
RewriteRuleやRewriteCondの構文エラー
403 Forbiddenや404 Not Foundの記録

2. RewriteLogを有効にする（Apache 2.2以前）

Apache 2.2以前ではRewriteLogディレクティブを使って、mod_rewriteの動作ログを取得できます。

RewriteLog "/var/log/apache2/rewrite.log"
RewriteLogLevel 3

RewriteLogLevelの値は1～9まで設定可能で、数値が大きいほど詳細なログが出力されます。
ただし、Apache 2.4以降ではRewriteLogは廃止されているため、LogLevelディレクティブを使用します。

3. Apache 2.4以降でデバッグログを取得する

Apache 2.4以降では、mod_rewriteのデバッグにはLogLevelを使います。

LogLevel alert rewrite:trace3

traceレベル：trace1からtrace8までがあり、数値が大きいほど詳細なデバッグ情報が出力されます。
ログの確認：

sudo tail -f /var/log/apache2/error.log

4. リライトルールの検証

リライトルールが正しく記述されているかを確認することが重要です。以下のポイントをチェックしましょう。

正規表現の間違い：

  RewriteRule ^product/([0-9]+)$ product.php?id=$1 [L]

^（行頭）、$（行末）が正しく使われているか確認します。
RewriteCondの条件ミス：

  RewriteCond %{HTTP_HOST} ^example.com$

ドメインやクエリストリングなどの条件が適切か確認します。

5. mod_rewriteが有効か確認する

mod_rewriteがインストールされていない、または有効化されていない可能性があります。

apachectl -M | grep rewrite

結果にrewrite_module (shared)と表示されていなければ、以下のコマンドで有効化します。

sudo a2enmod rewrite
sudo systemctl restart apache2

6. .htaccessの読み込み設定を確認する

.htaccessファイルが無視されている場合、mod_rewriteが動作しません。Apacheの設定ファイルでAllowOverrideディレクティブを確認します。

<Directory /var/www/html>
    AllowOverride All
</Directory>

AllowOverride Allを設定し、.htaccessのルールが適用されるようにします。
設定後はApacheを再起動します。

sudo systemctl restart apache2

7. 正規表現のテスト

正規表現が期待通りに動作しているか確認するために、オンラインの正規表現テスターを利用すると便利です。

ツール例：
regex101
RegExr

8. リライトルールを段階的に適用する

複雑なリライト設定を一度に記述せず、段階的にルールを追加してテストします。1つずつ動作を確認することで、原因の特定が容易になります。

これらのトラブルシューティング方法を活用することで、mod_rewriteの問題を効率的に解決できます。次のセクションでは、リライトルールの応用例をさらに詳しく解説します。

リライトルールの応用例

mod_rewriteは、シンプルなURL変換だけでなく、さまざまなシナリオで応用可能です。ここでは、実際の運用で役立つ応用的なリライトルールをいくつか紹介します。

1. ページごとの言語切り替え

多言語サイトでは、URLの一部で言語を切り替えることが一般的です。以下のルールで、/en/aboutのように言語をURLに組み込むことができます。

RewriteEngine On
RewriteRule ^(en|es|fr)/about$ about.php?lang=$1 [L]

説明：URLの先頭部分（enやes）が言語コードとして判別され、about.phpのクエリストリングに反映されます。

2. 特定のIPアドレスからのアクセスをブロック

不正なアクセスを防ぐために、特定のIPアドレスからのアクセスをブロックするリライト設定です。

RewriteEngine On
RewriteCond %{REMOTE_ADDR} ^123\.45\.67\.89$
RewriteRule ^(.*)$ - [F,L]

説明：IPアドレス123.45.67.89からのリクエストに対して、403 Forbiddenを返します。

3. モバイルデバイス専用のリダイレクト

モバイルデバイスからのアクセスを自動的にモバイル専用サイトへリダイレクトするルールです。

RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} (Android|iPhone|iPad) [NC]
RewriteRule ^$ /mobile/ [L,R=302]

説明：HTTP_USER_AGENTを利用し、モバイルデバイスからのアクセス時に/mobile/ディレクトリへリダイレクトします。

4. 古いURLから新しいURLへのマッピング

サイト構成の変更時に、古いURLから新しいURLへのリダイレクトを行います。

RewriteEngine On
RewriteRule ^old-page$ /new-page [R=301,L]
RewriteRule ^archive/(.*)$ /new-archive/$1 [R=301,L]

説明：old-pageはnew-pageへ、archive/以下のページはnew-archive/にリダイレクトされます。

5. ファイル拡張子を変更する

サイトの移行でファイルの拡張子が変更された場合でも、古い拡張子へのアクセスを新しい拡張子にリダイレクトできます。

RewriteEngine On
RewriteRule ^(.*)\.html$ $1.php [L]

説明：.htmlでアクセスされたURLは.phpへ自動的にリライトされます。

6. パラメータをクリーンなURLに変換

動的なクエリパラメータを、静的でわかりやすいURLに変換します。

RewriteEngine On
RewriteRule ^products/([0-9]+)$ product.php?id=$1 [L]

説明：/products/123 のようなURLを、内部的にproduct.php?id=123として処理します。

7. アクセス制限の時間帯設定

特定の時間帯のみアクセスを制限するルールです。

RewriteEngine On
RewriteCond %{TIME_HOUR} ^(23|00|01)$
RewriteRule ^(.*)$ - [F,L]

説明：23時から翌1時までのアクセスを禁止します。

8. メンテナンスモードの設定

サイトメンテナンス中に、訪問者を一時的にメンテナンスページへ誘導します。

RewriteEngine On
RewriteCond %{REQUEST_URI} !^/maintenance.html$
RewriteRule ^(.*)$ /maintenance.html [R=503,L]

説明：すべてのリクエストをmaintenance.htmlにリダイレクトします。ただし、maintenance.html自体は除外されます。

9. クライアントごとに異なるコンテンツを提供

特定のブラウザやOSに対して異なるページを提供します。

RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} MSIE
RewriteRule ^(.*)$ /ie-only.html [L]

説明：Internet Explorerでアクセスしたユーザーには、特別なページが表示されます。

これらの応用例を活用することで、Webサイトの柔軟性が向上し、ユーザビリティやセキュリティを強化できます。次のセクションでは、記事のまとめを行います。

まとめ

本記事では、Apacheのmod_rewriteを使用した基本的なURLリライト方法から応用例までを解説しました。mod_rewriteは、SEOの向上、ユーザビリティの改善、セキュリティ強化など、多くの利点を提供する強力なツールです。

基本的なリライトルールの設定方法を学び、リライトループを防ぐテクニックや、クエリストリングの書き換え、モバイルリダイレクトなど、実際の運用で役立つ応用例を取り上げました。

適切なリライトルールを活用することで、Webサイトの運営効率が向上し、訪問者にとってより快適なブラウジング環境を提供できます。今後もサイトの要件に応じてリライトルールを見直し、柔軟なURL設計を心がけましょう。