Apache mod_rewriteでクエリパラメーターを保持したURL書き換え設定例

Apacheのmod_rewriteは、URLの書き換えやリダイレクトを行う強力なモジュールで、ウェブサイトのURL構造を柔軟に変更することができます。特に、クエリパラメーターを保持したままのURLリダイレクトは、SEO対策やユーザビリティ向上に役立ちます。たとえば、「example.com/old-page?id=123」を「example.com/new-page?id=123」のようにリダイレクトする場合、クエリパラメーター（?id=123）をそのまま維持することが求められます。

本記事では、mod_rewriteの基本から始め、クエリパラメーターを保持するための具体的な設定例、正規表現の使い方、そして複数条件を用いた高度なリダイレクト方法まで詳しく解説します。実際の.htaccessファイルへの記述例やエラー時のデバッグ方法も紹介し、確実に動作するmod_rewrite設定を習得できる内容となっています。

mod_rewriteとは？基本の概要と役割

mod_rewriteは、Apache Webサーバーで利用できるURL書き換えモジュールです。クライアントからのリクエストに対して、指定したルールに従ってURLを動的に変更することができます。これにより、ユーザーに対してよりわかりやすいURLを提供したり、古いURLから新しいURLへリダイレクトすることで、SEOやサイトのメンテナンス性を向上させることが可能です。

mod_rewriteの最大の特徴は、柔軟な条件指定ができる点にあります。リクエストURLのパターンマッチングや、サーバー内部のディレクトリ構造に依存しない動的なURL生成が行えるため、モバイル向けのURL分岐や、言語切り替えなど幅広い用途で使用されています。

さらに、mod_rewriteは.htaccessファイルやApacheの設定ファイル（httpd.conf）を通じて簡単に設定できるため、多くのウェブサイトで活用されています。次の項目では、クエリパラメーターを保持したURL書き換えの具体的なユースケースについて掘り下げていきます。

クエリパラメーターを保持する必要性とユースケース

クエリパラメーターを保持したままURLを書き換えることは、多くのウェブサイトにおいて重要な役割を果たします。特にECサイトや検索機能を持つサイトでは、特定の商品IDや検索キーワードをURLに含めるケースが多く見られます。URLの構造を変更する際に、クエリパラメーターが失われると、ユーザーが意図したページにたどり着けなくなり、結果として離脱率の増加やコンバージョンの低下を招く可能性があります。

ユースケースの例

• ECサイトの商品ページリダイレクト
  「example.com/item?id=123」から「example.com/products/item?id=123」へURLを書き換える場合、商品IDを保持しなければ正しい商品ページが表示されません。
• 検索結果のフィルタリング
  検索ページで「example.com/search?category=books&sort=price」にアクセスした際、カテゴリやソート条件を維持しつつ、新しいURL形式にリダイレクトすることが求められます。
• キャンペーンURL
  広告キャンペーン用のトラッキングパラメーター（例: ?utm_source=google）が含まれるURLを、新しいランディングページにリダイレクトする場合でも、パラメーターを維持することで正確なトラッキングが可能になります。

このように、クエリパラメーターの保持はウェブサイトの機能やユーザー体験を損なわないために不可欠です。次に、mod_rewriteを使った具体的な設定方法について詳しく見ていきましょう。

.htaccessでの基本的なmod_rewrite設定方法

mod_rewriteを使用するには、Apacheがmod_rewriteモジュールを有効化している必要があります。設定は通常、ウェブサイトのルートディレクトリにある.htaccessファイルを通じて行います。.htaccessファイルは、ディレクトリ単位でApacheの設定を上書きできる便利な仕組みです。

mod_rewriteの有効化

まず、mod_rewriteがApacheで有効になっていることを確認します。以下のコマンドでApacheモジュールを確認・有効化できます。

sudo a2enmod rewrite
sudo systemctl restart apache2

次に、Apacheの設定ファイル（/etc/apache2/sites-available/000-default.confなど）に以下の記述を追加し、.htaccessの使用を許可します。

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

この設定を追加したら、Apacheを再起動します。

sudo systemctl restart apache2

.htaccessファイルの作成

ルートディレクトリに.htaccessファイルを作成（または編集）し、次のように記述します。

RewriteEngine On

これでmod_rewriteが有効になり、URLの書き換えルールを設定する準備が整いました。

シンプルなリダイレクト例

たとえば、example.com/old-pageをexample.com/new-pageにリダイレクトする場合は、次のように記述します。

RewriteRule ^old-page$ /new-page [L,R=301]

これにより、old-pageへのアクセスはnew-pageへ恒久的にリダイレクトされます（301リダイレクト）。

次の項目では、クエリパラメーターを保持しながらURLを書き換える具体例について詳しく解説します。

クエリパラメーターを保持した書き換えの具体例

クエリパラメーターを保持したままURLを書き換えるには、RewriteCondとRewriteRuleを組み合わせて記述します。これにより、ユーザーがアクセスした際にクエリパラメーターが失われることなく、新しいURLへリダイレクトできます。

クエリパラメーターを保持する基本例

以下は、example.com/old-page?id=123をexample.com/new-page?id=123にリダイレクトする設定例です。

RewriteEngine On
RewriteCond %{QUERY_STRING} ^id=([0-9]+)$
RewriteRule ^old-page$ /new-page?%{QUERY_STRING} [L,R=301]

説明:

• RewriteCond %{QUERY_STRING} ^id=([0-9]+)$は、idというクエリパラメーターが数値である場合に適用されます。
• RewriteRule ^old-page$ /new-page?%{QUERY_STRING}は、書き換え後のURLに元のクエリパラメーターを付与します。
• [L,R=301]は、リダイレクトを恒久的（301リダイレクト）にし、処理を停止することを意味します。

複数のクエリパラメーターを保持する例

example.com/old-page?category=books&sort=priceをexample.com/new-page?category=books&sort=priceにリダイレクトする場合の例です。

RewriteEngine On
RewriteCond %{QUERY_STRING} ^category=([^&]+)&sort=([^&]+)$
RewriteRule ^old-page$ /new-page?%{QUERY_STRING} [L,R=301]

このルールは、複数のクエリパラメーターが存在しても正確に保持します。%{QUERY_STRING}がすべてのクエリをそのまま引き継ぎます。

特定のクエリパラメーターを書き換える例

特定のパラメーターだけを変更したい場合は、次のように記述します。

RewriteEngine On
RewriteCond %{QUERY_STRING} ^category=books$
RewriteRule ^old-page$ /new-page?category=novels [L,R=301]

この設定は、category=booksをcategory=novelsに書き換えます。

クエリパラメーターを保持するリダイレクトは、ユーザーエクスペリエンスを向上させるだけでなく、SEOにも効果的です。次の項目では、正規表現を使用して柔軟なURLマッチングを行う方法を解説します。

正規表現を使った柔軟なURLマッチング方法

mod_rewriteでは、正規表現を活用して柔軟なURLマッチングを行うことができます。これにより、特定のパターンに一致するリクエストを一括で書き換えることが可能になります。正規表現を使うことで、より複雑なURLリダイレクトやクエリパラメーターの処理が容易になります。

正規表現の基本構文

• ^：文字列の先頭を表します。
• $：文字列の末尾を表します。
• ( )：キャプチャグループを作成し、一致した部分を後で利用できます。
• [ ]：括弧内のいずれか1文字にマッチします。
• +：直前の文字やグループが1回以上繰り返すことを示します。
• .*：任意の文字が0回以上繰り返すことを示します。

柔軟なURLマッチング例

たとえば、example.com/products/123のように、商品IDが異なる複数のURLを一括でexample.com/items/123にリダイレクトしたい場合は、次のように記述します。

RewriteEngine On
RewriteRule ^products/([0-9]+)$ /items/$1 [L,R=301]

説明:

• ^products/([0-9]+)$は、products/に続く数値（[0-9]+）をキャプチャします。
• /items/$1は、キャプチャした数値（$1）をitems/に置き換えてリダイレクトします。

クエリパラメーターを保持した正規表現の例

特定のクエリパラメーターを持つURLを新しいURLにリダイレクトする場合の例です。

RewriteEngine On
RewriteCond %{QUERY_STRING} ^id=([0-9]+)$
RewriteRule ^product-detail$ /new-detail/%1? [L,R=301]

ポイント:

• RewriteCond %{QUERY_STRING} ^id=([0-9]+)$で、idが数値であるクエリをキャプチャします。
• %1は、RewriteCondでキャプチャしたidを表します。

複数のクエリパラメーターを含む例

example.com/search?category=books&sort=priceのようなURLを新しい形式にリダイレクトする例です。

RewriteEngine On
RewriteCond %{QUERY_STRING} ^category=([^&]+)&sort=([^&]+)$
RewriteRule ^search$ /browse/%1/%2? [L,R=301]

説明:

• categoryとsortをそれぞれキャプチャし、/browse/の後に挿入します。
• %1はcategory、%2はsortに対応します。

正規表現を活用することで、さまざまなパターンのURLリダイレクトが可能になります。次の項目では、複数の条件を組み合わせた高度な書き換え方法を解説します。

複数の条件を使った高度な書き換え例

mod_rewriteでは、RewriteCondディレクティブを複数使用することで、複数の条件を組み合わせた高度なURL書き換えが可能です。これにより、ユーザーエージェントやリファラ、特定のパスなど、複数の条件を満たした場合のみリダイレクトを行うといった柔軟な対応ができます。

複数条件の基本構文

RewriteCondは、RewriteRuleの直前に記述し、複数行にわたって条件を指定できます。すべての条件が真である場合にのみ、次のRewriteRuleが適用されます。

条件に基づくURLリダイレクト例

たとえば、特定のパラメーターが存在し、かつ特定のリファラからのアクセスに対してのみリダイレクトを行う場合は、次のように記述します。

RewriteEngine On
RewriteCond %{QUERY_STRING} ^category=books$
RewriteCond %{HTTP_REFERER} example.com
RewriteRule ^search$ /browse/books? [L,R=301]

説明:

• RewriteCond %{QUERY_STRING} ^category=books$で、category=booksのクエリパラメーターを持つリクエストを対象とします。
• RewriteCond %{HTTP_REFERER} example.comで、リファラがexample.comである場合のみリダイレクトを実行します。
• 両方の条件を満たした場合に、/searchを/browse/booksにリダイレクトします。

ユーザーエージェントに基づく条件付きリダイレクト

特定のユーザーエージェント（例：Googlebot）に対してのみURLを書き換える場合の例です。

RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} Googlebot
RewriteRule ^old-page$ /seo-page [L,R=301]

ポイント:

• RewriteCond %{HTTP_USER_AGENT} Googlebotで、Googleのクローラーだけに適用します。
• 通常のユーザーには変更が影響せず、Googlebotのみold-pageからseo-pageへリダイレクトされます。

日付に基づくリダイレクトの例

特定の期間だけ特定のURLを書き換えたい場合には、タイムスタンプを条件として使用できます。

RewriteEngine On
RewriteCond %{TIME_YEAR} ^2025$
RewriteCond %{TIME_MON} ^01$
RewriteRule ^sale$ /new-year-sale [L,R=302]

説明:

• TIME_YEARとTIME_MONを利用して、2025年1月にアクセスがあった場合のみ/saleを/new-year-saleに一時リダイレクトします。
• R=302は一時リダイレクトを示します。

IPアドレスに基づくアクセス制限

特定のIPアドレスからのアクセスをブロックする場合の例です。

RewriteEngine On
RewriteCond %{REMOTE_ADDR} ^192\.168\.1\.100$
RewriteRule .* - [F,L]

説明:

• REMOTE_ADDRで特定のIPアドレスを指定します。
• RewriteRule .* - [F,L]は403 Forbiddenエラーを返します。

複数条件を組み合わせることで、より細かいコントロールが可能になり、柔軟なリダイレクトルールを作成できます。次の項目では、エラー時のデバッグ方法と注意点について解説します。

エラー時のデバッグ方法と注意点

mod_rewriteの設定を行う際、思った通りにリダイレクトが動作しないことがあります。これは、正規表現のミスや条件の不一致、mod_rewrite自体の無効化などが原因となります。こうした問題を迅速に解決するために、適切なデバッグ手法を知っておくことが重要です。

デバッグの基本手順

1. mod_rewriteが有効であることを確認
   Apacheでmod_rewriteが有効になっているか確認します。以下のコマンドで確認および有効化を行います。

sudo a2enmod rewrite
sudo systemctl restart apache2

2. .htaccessの場所と記述ミスを確認

• .htaccessファイルが正しい場所にあることを確認します。通常はルートディレクトリ（/var/www/htmlなど）に配置されます。
• ファイルの記述ミスがないか確認し、RewriteEngine Onが必ず記載されていることを確かめます。

2. Apacheのエラーログを確認
   リダイレクトが機能しない場合、Apacheのエラーログを確認します。

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

エラーログには、記述ミスやパーミッションエラーなどの情報が記録されます。

mod_rewriteのログを有効化する

mod_rewriteの挙動を詳細に記録するためには、RewriteLogを有効にします。以下の設定をApacheの仮想ホスト設定ファイルや.htaccessに追加します。

LogLevel alert rewrite:trace6

これにより、リライトの処理過程がerror.logに詳細に出力されます。

一般的なエラーとその対策

1. リダイレクトが無限ループになる

RewriteRule ^about$ /about [L,R=301]

問題点: 自身にリダイレクトしてしまうループが発生します。
対策: クエリパラメーターや条件を追加し、リダイレクトループを防止します。

RewriteCond %{REQUEST_URI} !^/about$
RewriteRule ^about$ /about [L,R=301]

2. クエリパラメーターが失われる

RewriteRule ^search$ /new-search [L,R=301]

問題点: クエリパラメーターが保持されません。
対策: %{QUERY_STRING}を使用して、元のクエリを付与します。

RewriteRule ^search$ /new-search?%{QUERY_STRING} [L,R=301]

3. 意図しないURLがリダイレクトされる
   正規表現の記述ミスで不要なURLまでリダイレクトされる場合があります。
   対策: RewriteCondを使用して条件を追加し、正確にマッチさせます。

RewriteCond %{REQUEST_URI} ^/old-page$
RewriteRule ^old-page$ /new-page [L,R=301]

デバッグが難航する場合

• 設定ファイルを小さく分けて、一つずつ確認しながら適用します。
• RewriteLogで出力された内容をもとに、どの条件がマッチしなかったのかを特定します。
• 他の設定ファイル（httpd.confやsites-availableの設定）にmod_rewriteに影響する記述がないか確認します。

エラーの原因を適切に特定し、迅速に修正することで、mod_rewriteのトラブルシューティングがスムーズに進みます。次の項目では、本記事の内容を簡潔にまとめます。

まとめ

本記事では、Apacheのmod_rewriteを使用してクエリパラメーターを保持したままURLを書き換える方法について解説しました。mod_rewriteの基本から始まり、クエリパラメーターを扱う具体的な記述例、正規表現を使った柔軟なマッチング方法、複数の条件を用いた高度なリダイレクト設定、さらにはエラー時のデバッグ方法までを網羅しました。

クエリパラメーターを保持したリダイレクトは、ユーザーエクスペリエンスの向上やSEO対策に直結する重要な要素です。正しいmod_rewriteの設定は、リダイレクトのトラブルを防ぎ、サイトの健全な運営を支えます。

.htaccessの活用方法やデバッグ手法をマスターすることで、より効果的で柔軟なURL管理が可能となります。ぜひ、今回紹介した設定例を自身のウェブサイトで活用し、快適なユーザー体験を提供してください。