Apache mod_rewriteでAPIエンドポイントをリダイレクトする方法【設定例付き】

Apacheのmod_rewriteモジュールは、URLのリダイレクトや書き換えを行うための非常に強力なツールです。特にAPIエンドポイントを別のURLにリダイレクトする場合、シンプルな.htaccessファイルの設定で柔軟に対応できるため、Webサービスの移行やAPIバージョン管理などに役立ちます。

本記事では、mod_rewriteを使用してAPIエンドポイントを別のURLにリダイレクトする方法について詳しく解説します。導入方法から基本的なリダイレクト設定、条件付きリダイレクトの応用例まで、具体的なコード例を交えながら説明していきます。

Apacheを使用している環境でAPIのリダイレクトが必要な場合、本記事を参考にすることで、効率的かつ確実に設定を行えるようになります。まずは、mod_rewriteの概要と導入方法から見ていきましょう。

mod_rewriteとは？

mod_rewriteは、Apache HTTPサーバーでURLの書き換えやリダイレクトを行うためのモジュールです。このモジュールを使用すると、アクセスされるURLを動的に変更し、ユーザーに異なるリソースを提供したり、古いURLを新しいURLにリダイレクトしたりすることが可能になります。

mod_rewriteの最大の特徴は、その柔軟性と強力な条件分岐機能です。正規表現を用いてURLをパターンマッチングし、特定の条件下で異なる処理を実行することができます。これにより、URLの構造変更やAPIのバージョン管理、リソースの移動などにも簡単に対応できます。

例えば、

• 古いURLから新しいURLへの301リダイレクト
• 特定のIPアドレスやユーザーエージェントに応じた処理
• アクセスされるURLの隠蔽（クリーンURL）

といった処理が可能になります。

次のセクションでは、mod_rewriteの導入と有効化の手順について詳しく説明します。

mod_rewriteの導入と有効化手順

Apacheでmod_rewriteを使用するためには、モジュールがインストールされており、サーバーで有効化されている必要があります。以下に、mod_rewriteを導入して有効化する手順を紹介します。

1. mod_rewriteのインストール確認

ほとんどのApache環境では、mod_rewriteはデフォルトでインストールされていますが、念のため確認しておきましょう。

apache2ctl -M | grep rewrite

このコマンドを実行し、rewrite_module (shared)という出力があればmod_rewriteはインストール済みです。出力がない場合は、以下のコマンドでインストールします。

Debian/Ubuntuの場合

sudo a2enmod rewrite
sudo systemctl restart apache2

CentOS/RHELの場合

sudo yum install httpd-mod_rewrite
sudo systemctl restart httpd

2. Apache設定ファイルの変更

mod_rewriteがインストールされていても、Apacheの設定でAllowOverrideが無効になっているとリダイレクトが機能しません。以下の手順で、設定を変更します。

/etc/apache2/apache2.conf（Ubuntu/Debian）または /etc/httpd/conf/httpd.conf（CentOS/RHEL）を編集します。

sudo nano /etc/apache2/apache2.conf

<Directory /var/www/>ブロック内のAllowOverride NoneをAllowOverride Allに変更します。

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

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

sudo systemctl restart apache2

3. 動作確認

.htaccessファイルを作成し、mod_rewriteが正しく動作するか確認します。

/var/www/html/.htaccessに以下を追加します。

RewriteEngine On
RewriteRule ^test$ /index.html [L]

ブラウザでhttp://example.com/testにアクセスし、index.htmlが表示されればmod_rewriteは正しく有効化されています。

次は、実際にAPIエンドポイントをリダイレクトする具体的な設定例を紹介します。

基本的なリダイレクト設定例

mod_rewriteを使用したURLリダイレクトは、シンプルなルールで簡単に設定できます。ここでは、基本的なリダイレクト設定例を紹介します。

1. 単純なリダイレクトの例

特定のURLを別のURLにリダイレクトするシンプルな例です。

例：/old-page を /new-page にリダイレクトする

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

• RewriteEngine On – mod_rewriteを有効化します。
• ^old-page$ – アクセスされるURLのパターンです（正規表現を使用）。
• /new-page – リダイレクト先のURLです。
• [R=301,L] – 301リダイレクト（恒久的なリダイレクト）で処理を終了します。

ブラウザでhttp://example.com/old-pageにアクセスすると、自動的に/new-pageへリダイレクトされます。

2. ドメイン全体のリダイレクト

特定のドメインから別のドメインにアクセスをリダイレクトする方法です。

例：www.example.com から example.com へリダイレクトする

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

• RewriteCond – リダイレクト条件を指定します。この場合、ホスト名がwww.example.comに一致する場合にリダイレクトします。
• $1 – マッチしたURLの後続部分を維持してリダイレクトします。
• [NC] – 大文字小文字を区別しません。

3. HTTPSへのリダイレクト

HTTPアクセスをHTTPSに強制的にリダイレクトする設定例です。

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

• RewriteCond %{HTTPS} !=on – HTTPSでない場合にリダイレクトします。
• %{HTTP_HOST} – 現在のホスト名を保持します。

これにより、http://example.comへのアクセスはすべてhttps://example.comにリダイレクトされます。

次は、APIエンドポイントの具体的なリダイレクト方法について詳しく見ていきます。

APIエンドポイントリダイレクトの実装例

APIエンドポイントを別のURLにリダイレクトする場合、mod_rewriteを使用することで柔軟なリダイレクトが可能になります。特に、APIのバージョンアップやエンドポイントの変更時に有効です。ここでは、APIエンドポイントを別のパスやサーバーにリダイレクトする具体例を紹介します。

1. APIバージョン変更によるリダイレクト

新しいバージョンのAPIにユーザーを誘導する例です。

例：/api/v1/から/api/v2/にリダイレクトする

RewriteEngine On
RewriteRule ^api/v1/(.*)$ /api/v2/$1 [R=301,L]

• /api/v1/以下のすべてのリクエストが/api/v2/にリダイレクトされます。
• $1はv1/の後ろに続くパスをキャプチャし、そのままv2/に付加します。
• これにより、/api/v1/usersは自動的に/api/v2/usersにリダイレクトされます。

2. APIドメイン変更によるリダイレクト

APIの提供ドメインが変更された場合に、リクエストを新しいドメインに転送します。

例：api.example.com から newapi.example.com へリダイレクト

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

• api.example.comへのリクエストは自動的にnewapi.example.comにリダイレクトされます。
• すべてのAPIエンドポイントが変更される際に有効です。

3. 特定のエンドポイントだけをリダイレクト

一部のエンドポイントだけを別のパスにリダイレクトする例です。

例：/api/loginを/auth/loginにリダイレクト

RewriteEngine On
RewriteRule ^api/login$ /auth/login [R=302,L]

• 302は一時的なリダイレクトで、変更が恒久的でない場合に使用します。
• これにより、/api/loginへのアクセスは/auth/loginにリダイレクトされます。

4. 外部APIへのリダイレクト

エンドポイントを外部APIにリダイレクトする方法もあります。

例：/api/weather へのアクセスを外部APIへ転送

RewriteEngine On
RewriteRule ^api/weather$ https://externalapi.com/weather [P]

• [P]フラグを使用することで、プロキシとして外部APIにリクエストを転送します。
• クライアントにはexternalapi.comのURLは見えず、あたかも自サイトがAPIを提供しているように見せられます。

次のセクションでは、リダイレクトに条件を加える方法を解説します。

条件付きリダイレクトの設定方法

特定の条件下でのみAPIエンドポイントをリダイレクトしたい場合は、mod_rewriteのRewriteCondディレクティブを活用します。これにより、ユーザーエージェントやIPアドレス、リクエストメソッドなどに応じた柔軟なリダイレクトが可能になります。以下に、条件付きリダイレクトの具体例をいくつか紹介します。

1. IPアドレスによる条件付きリダイレクト

特定のIPアドレスからのアクセスのみをリダイレクトします。

例：192.168.1.100からのアクセスのみ/api/v2/にリダイレクト

RewriteEngine On
RewriteCond %{REMOTE_ADDR} ^192\.168\.1\.100$
RewriteRule ^api/v1/(.*)$ /api/v2/$1 [R=301,L]

• RewriteCond %{REMOTE_ADDR}は、アクセス元のIPアドレスを指定します。
• 192.168.1.100のIPからアクセスされた場合のみ/api/v1/が/api/v2/にリダイレクトされます。

2. ユーザーエージェントによる条件付きリダイレクト

特定のユーザーエージェント（ブラウザやアプリ）からのアクセスをリダイレクトします。

例：Googlebotのみ別のAPIエンドポイントにリダイレクト

RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} Googlebot
RewriteRule ^api/data$ /api/data-for-bots [R=302,L]

• Googlebotが/api/dataにアクセスした場合、/api/data-for-botsにリダイレクトします。
• 302は一時的なリダイレクトで、必要に応じて301に変更可能です。

3. 特定の時間帯でのリダイレクト

サーバーメンテナンス時間帯のみ別のページにリダイレクトする設定です。

例：深夜0時から3時までメンテナンスページにリダイレクト

RewriteEngine On
RewriteCond %{TIME_HOUR} ^(00|01|02|03)$
RewriteRule ^api/(.*)$ /maintenance.html [R=503,L]

• TIME_HOURはサーバーの現在時刻を取得します。
• 深夜0時から3時までの間、APIへのアクセスはmaintenance.htmlにリダイレクトされます。
• 503は「サービス利用不可」を意味するステータスコードです。

4. リクエストメソッドでの条件付きリダイレクト

POSTメソッドなど特定のHTTPメソッドのみをリダイレクトします。

例：POSTリクエストを/api/new-endpointにリダイレクト

RewriteEngine On
RewriteCond %{REQUEST_METHOD} POST
RewriteRule ^api/submit$ /api/new-endpoint [R=307,L]

• REQUEST_METHODはHTTPメソッドを取得します。
• POSTリクエストが/api/submitに対して行われると、新しいエンドポイント/api/new-endpointにリダイレクトします。
• 307は「一時的リダイレクト」で、メソッドを維持したままリダイレクトします。

5. クエリパラメータによる条件付きリダイレクト

特定のクエリパラメータが含まれている場合のみリダイレクトします。

例：?version=oldのAPIリクエストを新バージョンにリダイレクト

RewriteEngine On
RewriteCond %{QUERY_STRING} version=old
RewriteRule ^api/data$ /api/data-v2 [R=301,L]

• クエリパラメータversion=oldが含まれるリクエストが/api/dataに対して行われると、/api/data-v2にリダイレクトします。

これらの条件付きリダイレクトを活用することで、柔軟かつ高度なAPI管理が可能になります。次は、リダイレクト設定のテスト方法とトラブルシューティングについて解説します。

リダイレクトのテストとトラブルシューティング

mod_rewriteによるリダイレクト設定を行った後は、必ず動作確認を行い、意図したとおりにリダイレクトが機能しているかを検証する必要があります。ここでは、リダイレクトのテスト方法と、トラブルが発生した際の対処方法について解説します。

1. リダイレクトのテスト方法

1-1. ブラウザでのテスト

最も簡単な方法は、ブラウザで対象のURLにアクセスすることです。

• 例：http://example.com/api/v1/users にアクセスし、/api/v2/usersにリダイレクトされるか確認します。
• ブラウザの開発者ツール（F12）を開き、ネットワークタブでリクエストのステータスコードが301や302であることを確認します。

1-2. curlコマンドでのテスト

コマンドラインでcurlを使用すると、詳細なレスポンスが確認できます。

curl -I http://example.com/api/v1/users

• -IオプションでHTTPヘッダーだけを取得し、リダイレクト先が表示されます。
• Locationヘッダーが新しいURLを示しているか確認します。

HTTP/1.1 301 Moved Permanently
Location: http://example.com/api/v2/users

1-3. Apacheのテストモード

mod_rewriteにはリダイレクトルールのテストを行うツールがあります。

apachectl configtest

• 上記コマンドで設定ファイルの構文が正しいかを確認します。
• エラーがある場合は、エラーメッセージが表示されます。

2. よくあるトラブルと対処方法

2-1. リダイレクトが機能しない

• 原因1：mod_rewriteが有効になっていない

  a2enmod rewrite
  sudo systemctl restart apache2

モジュールが無効な場合は、a2enmod rewriteで有効化し、Apacheを再起動します。

• 原因2：AllowOverrideの設定ミス
  Apache設定ファイルのAllowOverrideがNoneになっている場合、.htaccessのリダイレクトが無効になります。

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

上記のように設定し、Apacheを再起動してください。

2-2. リダイレクトが無限ループする

• リダイレクトルールが曖昧な場合や条件が不足している場合、リダイレクトが無限に繰り返されることがあります。

  RewriteCond %{REQUEST_URI} !^/api/v2/
  RewriteRule ^api/v1/(.*)$ /api/v2/$1 [R=301,L]

RewriteCondで除外条件を追加し、ループを防止します。

2-3. 404エラーが発生する

• リダイレクト先のURLが存在しない可能性があります。
  リダイレクト先のパスが正しいか確認し、存在するページやAPIエンドポイントであることを確かめてください。

3. ログを使ったトラブルシューティング

Apacheのリダイレクトエラーの原因を特定するために、ログを確認します。

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

リダイレクトのミスやエラーがログに記録されているため、エラー内容を元に修正します。

mod_rewriteのデバッグログを有効にする方法

LogLevel alert rewrite:trace6

• Apache設定ファイルに追記し、詳細なmod_rewriteのログを出力します。
• 再起動後、詳細なリダイレクトプロセスがログに記録され、デバッグが容易になります。

次は、リダイレクト設定のまとめと記事の振り返りを行います。

まとめ

本記事では、Apache mod_rewriteを使用してAPIエンドポイントを別のURLにリダイレクトする方法について詳しく解説しました。mod_rewriteの基本的な仕組みから導入・有効化の手順、APIエンドポイントの具体的なリダイレクト例、さらに条件付きリダイレクトの応用方法まで幅広く紹介しました。

リダイレクト設定は、APIのバージョン管理やサービス移行時に不可欠な技術です。特に、正規表現を活用した柔軟なルールや、IPアドレスやユーザーエージェントなど特定の条件下でのリダイレクトは、セキュリティ向上やユーザー体験の改善に役立ちます。

リダイレクト設定後は、必ずテストを行い、意図しない動作や無限ループなどが発生していないかを確認しましょう。トラブルが発生した場合は、Apacheのエラーログを活用して原因を特定し、適切に対処することが重要です。

これで、mod_rewriteを活用したAPIエンドポイントのリダイレクト設定は完了です。今後のプロジェクトで、効率的にURLの管理やリダイレクトを行えるようになるでしょう。