MENU
  1. ホーム
  2. Apache
  3. Apache mod_rewriteでURL書き換えを設定する方法【完全ガイド】

Apache mod_rewriteでURL書き換えを設定する方法【完全ガイド】

Apache

Apacheのmod_rewriteモジュールは、URLを動的に書き換えるための強力なツールです。SEOの向上、セキュリティ対策、ユーザーエクスペリエンスの向上など、さまざまな目的で利用されます。たとえば、古いURL構造を新しいものにリダイレクトしたり、クリーンで人間が読みやすいURLに変換することが可能です。

本記事では、mod_rewriteの基本的な概念から、httpd.confを使った具体的な設定方法、一般的なURLリライトの例、そして実際の運用で役立つ高度な設定方法までを詳しく解説します。Apacheサーバーの管理者やWeb開発者が、効率的にURLを書き換えられるようになることを目指します。

初心者にもわかりやすいように、コード例や実際の設定ファイルを交えながらステップバイステップで進めていきます。

目次

mod_rewriteとは？その役割と利点


mod_rewriteは、Apache HTTPサーバーに組み込まれたモジュールで、URLを書き換える機能を提供します。これは、アクセスされるURLを異なるパターンに変換することで、ユーザーが意図するページに適切に誘導するための重要な役割を果たします。

mod_rewriteの主な役割


mod_rewriteの役割は多岐にわたりますが、特に以下のようなシナリオで活用されます。

  • SEOの向上：動的なURL（例: example.com/index.php?id=123）をクリーンでわかりやすいURL（例: example.com/products/item123）に変換します。検索エンジンのインデックスが最適化されます。
  • ユーザー体験の向上：ユーザーにとって理解しやすいURLを提供し、アクセスのしやすさを改善します。
  • セキュリティ強化：直接的なパスを隠蔽し、サーバー内部構造が外部に露出しないようにします。
  • リダイレクト管理：古いページへのアクセスを新しいURLにリダイレクトし、リンク切れを防ぎます。

mod_rewriteの利点

  • 柔軟なルール設定：正規表現を活用することで、複雑なURLパターンの書き換えも容易に行えます。
  • パフォーマンスの向上：適切なリダイレクトを行うことで、サーバーのリソース消費を抑えつつ、迅速なレスポンスが可能になります。
  • スケーラビリティ：複数の条件を設定し、アクセス状況に応じた多様な処理が実現できます。

mod_rewriteは非常に柔軟で、ほぼ無制限にURLを操作できます。そのため、適切に利用すれば、Webサイトの運用効率と利便性が飛躍的に向上します。次のセクションでは、mod_rewriteをApacheで有効にする方法を詳しく解説します。

mod_rewriteを有効にする手順


Apacheでmod_rewriteを利用するためには、サーバー設定でこのモジュールを有効にする必要があります。デフォルトでは無効になっていることが多いため、明示的に設定を行います。以下に、mod_rewriteを有効にするための具体的な手順を説明します。

1. mod_rewriteがインストールされているか確認


まず、Apacheにmod_rewriteがインストールされているかを確認します。以下のコマンドで確認できます。

apachectl -M | grep rewrite

もし、以下のような出力が表示されればmod_rewriteは有効です。

rewrite_module (shared)


表示されない場合は、次の手順で有効にします。

2. mod_rewriteを有効にする

2.1 Debian/Ubuntu系のOSの場合

以下のコマンドを実行してmod_rewriteを有効にします。

sudo a2enmod rewrite
sudo systemctl restart apache2

2.2 CentOS/RHEL系の場合

/etc/httpd/conf/httpd.confを編集します。

sudo vi /etc/httpd/conf/httpd.conf

以下の行を探し、コメントアウトを解除します（#を削除）。

#LoadModule rewrite_module modules/mod_rewrite.so

その後、Apacheを再起動します。

sudo systemctl restart httpd

3. .htaccessの設定を許可


次に、.htaccessファイルでmod_rewriteを使用するために、httpd.confでAllowOverrideを有効にする必要があります。

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


これにより、ディレクトリ内の.htaccessファイルでURLリライトが可能になります。

4. 設定が反映されたか確認


再度以下のコマンドで、mod_rewriteが有効になっていることを確認します。

apachectl -M | grep rewrite


これでmod_rewriteが有効になります。次のセクションでは、URL書き換えルールの基本構造について説明します。

URL書き換えルールの基本構造


mod_rewriteを使用してURLを書き換えるには、RewriteRuleやRewriteCondといったディレクティブを利用します。これらを組み合わせることで、柔軟なURLリライトが可能になります。

RewriteRuleの基本構文

RewriteRule パターン 置換先 [フラグ]
  • パターン：書き換え対象となるURLの正規表現。
  • 置換先：書き換え後のURLまたはファイルパス。
  • フラグ：リライト処理の動作を制御するオプション（例：Lは「最後」の意味）。

RewriteRuleの例

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


このルールは、/products/123 というURLを /show_product.php?id=123 に書き換えます。

RewriteCondの基本構文


RewriteCondは、RewriteRuleが適用される条件を定義します。これを使うことで、特定の条件に一致する場合のみURLを書き換えることができます。

RewriteCond 条件式 [オプション]
RewriteRule パターン 置換先 [フラグ]

RewriteCondの例

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


この設定は、www.example.comへのアクセスをexample.comにリダイレクトします。

フラグの種類と役割

  • L（Last）：一致した時点でリライトを終了する。
  • R（Redirect）：リダイレクトを行う。R=301とすることで301リダイレクトになる。
  • NC（No Case）：大文字・小文字を区別しない。
  • QSA（Query String Append）：クエリストリングを維持して書き換えを行う。

RewriteRuleとRewriteCondの組み合わせ例

RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^images/(.*)\.jpg$ /no-image.jpg [L]


このルールは、images/ディレクトリ内に存在しないjpgファイルが要求された場合に、no-image.jpgに書き換えます。

次のセクションでは、よく使われるURLリライトの具体例を紹介します。

よく使われるURLリライトの例


mod_rewriteを活用すると、WebサイトのURL構造を最適化し、ユーザー体験やSEOの向上が期待できます。ここでは、実際によく使われるURLリライトの例を紹介します。

1. wwwあり・なしの統一


Webサイトへのアクセスで「www」が付く場合と付かない場合があります。どちらかに統一することで、SEO的にも評価が分散しません。

wwwを外す例

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


wwwを付ける例

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

2. HTTPからHTTPSへのリダイレクト


セキュリティ強化のため、HTTPアクセスをHTTPSにリダイレクトする設定です。

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

3. index.phpを隠す


URLからindex.phpを取り除き、シンプルでクリーンなURLを実現します。

RewriteRule ^index\.php$ / [L,R=301]  
RewriteCond %{REQUEST_FILENAME} !-f  
RewriteCond %{REQUEST_FILENAME} !-d  
RewriteRule . /index.php [L]

4. 末尾のスラッシュを付ける/付けない


URLの末尾にスラッシュがあるかないかを統一します。

スラッシュを付ける例

RewriteCond %{REQUEST_URI} !/$  
RewriteCond %{REQUEST_FILENAME} -d  
RewriteRule ^(.*)$ http://%{HTTP_HOST}/$1/ [L,R=301]


スラッシュを削除する例

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

5. 404エラーページのカスタマイズ


存在しないページにアクセスされた場合に、カスタムの404ページを表示する設定です。

RewriteCond %{REQUEST_FILENAME} !-f  
RewriteCond %{REQUEST_FILENAME} !-d  
RewriteRule . /404.html [L]

これらの設定を使うことで、WebサイトのURL構造が統一され、管理が容易になります。次のセクションでは、mod_rewriteの設定が正しく機能しているかを確認する方法を解説します。

mod_rewriteのテスト方法とデバッグ


mod_rewriteの設定は強力ですが、記述ミスや条件の誤りがあると期待通りに動作しません。ここでは、mod_rewriteの動作確認やデバッグ方法を詳しく解説します。

1. RewriteRuleの動作確認方法


まずは、設定したRewriteRuleが正しく機能しているかを確認します。

1.1 .htaccessの位置と権限を確認

.htaccessファイルが正しいディレクトリに存在していること、およびApacheがこのファイルを読み込めるように権限が設定されていることを確認します。

ls -l /var/www/html/.htaccess
  • 権限が644であることが望ましいです。
chmod 644 /var/www/html/.htaccess

1.2 .htaccessが有効になっているか確認

httpd.confまたはapache2.confで、.htaccessが適切に動作するように以下の設定がされているか確認します。

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


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

sudo systemctl restart apache2

2. RewriteRuleのデバッグ方法


mod_rewriteの動作をデバッグするには、RewriteLogやmod_rewriteのログ機能を利用します。

2.1 ログを有効にする

httpd.confまたは.htaccessに以下を追加します。

LogLevel alert rewrite:trace3
  • trace3の数値を大きくすると、より詳細なログが記録されます。
  • Apacheを再起動して設定を反映します。
sudo systemctl restart apache2

2.2 ログの確認

Apacheのエラーログファイルでrewriteの動作を確認します。

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

3. RewriteRuleのシミュレーションツール


オンラインでRewriteRuleをテストできるシミュレーションツールもあります。以下のツールを活用すると、記述ミスを事前に防げます。

4. よくあるエラーと対処法

4.1 500 Internal Server Error

  • .htaccessの記述ミスが原因。特に正規表現やRewriteCondの間違いが多いです。
  • Apacheのエラーログを確認し、該当箇所を修正します。

4.2 リダイレクトループ

  • URLが無限に書き換えられてしまう状態。
  • RewriteCondで条件を追加し、不要なリダイレクトを防ぎます。
RewriteCond %{REQUEST_URI} !^/index.php$

これらの手順で、mod_rewriteの動作を確認し、正確なURLリライトを実現できます。次のセクションでは、失敗しやすいポイントとその対策について解説します。

失敗しやすいポイントと対策


mod_rewriteは強力ですが、記述ミスや設定の漏れにより、思わぬトラブルが発生することがあります。ここでは、mod_rewriteの設定で失敗しやすいポイントと、その対策方法について解説します。

1. RewriteRuleの記述ミス


ポイント: 正規表現の記述ミスや不正なパス指定が原因で、ルールが期待通りに動作しないことがあります。
例:

RewriteRule ^product/(.*) /item.php?id=$1 [L]


この記述では、productへのアクセスはリダイレクトされますが、/product/などの末尾スラッシュがつく場合は機能しません。

対策: 末尾スラッシュを含むパターンを考慮します。

RewriteRule ^product/(.*)/?$ /item.php?id=$1 [L]

2. リダイレクトループの発生


ポイント: リダイレクトの条件を適切に設定しないと、無限ループが発生します。
例:

RewriteRule ^(.*)$ http://example.com/$1 [L,R=301]


このルールでは、すべてのアクセスが再帰的にリダイレクトされます。

対策: すでにリダイレクトされているリクエストを除外する条件を追加します。

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

3. AllowOverrideの設定漏れ


ポイント: .htaccessが有効になっていないと、mod_rewriteが機能しません。
対策: httpd.confまたはapache2.confでAllowOverride Allを設定し、.htaccessが適用されるようにします。

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

4. キャッシュの影響


ポイント: 変更を加えた後も、ブラウザやサーバー側のキャッシュが原因でリライトが反映されないことがあります。
対策:

  • ブラウザのキャッシュをクリアするか、シークレットモードで動作を確認します。
  • Apacheのキャッシュをクリアして再起動します。
sudo systemctl restart apache2

5. RewriteCondの論理エラー


ポイント: RewriteCondで複数条件を指定する際、論理関係が正しく設定されていないと意図しない挙動になります。
例:

RewriteCond %{REQUEST_FILENAME} !-f  
RewriteCond %{REQUEST_FILENAME} !-d  
RewriteRule ^(.*)$ /index.php [L]


このルールでは、存在しないファイルやディレクトリ以外が全てindex.phpにリライトされます。

対策: 条件の意味を正しく理解し、必要に応じてORフラグを利用します。

RewriteCond %{REQUEST_FILENAME} !-f [OR]  
RewriteCond %{REQUEST_FILENAME} !-d  
RewriteRule ^(.*)$ /index.php [L]

6. 予期しないURLの処理


ポイント: 特定のディレクトリやファイルだけ除外したい場合がありますが、条件が曖昧だと誤動作します。
対策: 特定のディレクトリやファイルを正規表現で明確に除外します。

RewriteCond %{REQUEST_URI} !^/static/  
RewriteRule ^(.*)$ /dynamic.php [L]

mod_rewriteを使いこなすには、細かな設定ミスを見逃さずにデバッグし、慎重にルールを設計することが重要です。次のセクションでは、さらに高度なURLリライトの例を紹介します。

高度なURL書き換え例


mod_rewriteを活用すると、複雑な条件に基づいたURLのリライトが可能です。ここでは、動的パラメータや複数条件を使用した高度な書き換え例を紹介します。

1. クエリストリングの動的リライト


URLに含まれるクエリストリング（例：?id=123&category=books）を動的に書き換えて、SEOに強いクリーンなURLを実現します。

例:

RewriteCond %{QUERY_STRING} ^id=([0-9]+)&category=([a-z]+)$  
RewriteRule ^product$ /%2/%1 [L,R=301]


結果:
example.com/product?id=123&category=books → example.com/books/123

2. 特定の拡張子をリダイレクト


拡張子が.phpや.htmlのファイルへのアクセスを、自動的にスラッシュ付きのURLにリダイレクトします。

例:

RewriteRule ^(.*)\.php$ /$1/ [L,R=301]  
RewriteRule ^(.*)\.html$ /$1/ [L,R=301]


結果:
example.com/index.php → example.com/index/

3. モバイルユーザーを別ページにリダイレクト


モバイルデバイスからのアクセス時に、専用のページにリダイレクトします。

例:

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


結果:
example.com/products → example.com/mobile/products

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


メンテナンス時にすべてのリクエストをmaintenance.htmlにリダイレクトし、特定のIPアドレスからのアクセスは通常通り許可します。

例:

RewriteCond %{REMOTE_ADDR} !^123\.45\.67\.89$  
RewriteRule ^(.*)$ /maintenance.html [L]


結果:
example.com/products → example.com/maintenance.html（ただし特定IPは例外）

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


サイトリニューアル後に、古いURL構造から新しいURL構造へ自動でリダイレクトします。

例:

RewriteRule ^old-section/(.*)$ /new-section/$1 [L,R=301]


結果:
example.com/old-section/article1 → example.com/new-section/article1

6. IP制限付きディレクトリアクセス


特定のIPアドレスからのみアクセス可能なディレクトリを設定します。

例:

RewriteCond %{REMOTE_ADDR} !^123\.45\.67\.89$  
RewriteRule ^admin/ - [F]


結果:
許可されていないIPアドレスがexample.com/adminにアクセスすると403エラーが表示されます。

7. 動的言語切り替え


URLに/enや/jpを含めることで、ユーザーの言語を動的に切り替えます。

例:

RewriteRule ^(en|jp)/(.*)$ /index.php?lang=$1&page=$2 [L]


結果:
example.com/en/contact → example.com/index.php?lang=en&page=contact

これらの設定例を活用することで、より柔軟で効率的なサイト運用が可能になります。次のセクションでは、実際のhttpd.confに記述する例を紹介します。

実際のhttpd.conf例


mod_rewriteをhttpd.confに直接記述して運用する場合、効率的でメンテナンス性の高い設定が求められます。ここでは、実際に使用されるhttpd.confの具体例を示し、ディレクトリ単位やバーチャルホストでの設定例を解説します。

1. mod_rewriteの基本設定


まず、httpd.confでmod_rewriteを有効にするための設定を行います。

LoadModule rewrite_module modules/mod_rewrite.so

これがコメントアウトされている場合は#を削除し、Apacheを再起動します。

2. バーチャルホストでのmod_rewrite設定


特定のドメインに対してURL書き換えを設定する場合は、バーチャルホストに記述します。

例:

<VirtualHost *:80>
    ServerAdmin admin@example.com
    DocumentRoot /var/www/html
    ServerName example.com
    ServerAlias www.example.com

    <Directory /var/www/html>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

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


解説:

  • www.example.com へのアクセスは example.com にリダイレクトされます。
  • AllowOverride All により、.htaccessでのmod_rewriteの設定も可能になります。

3. HTTPSリダイレクト設定


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

<VirtualHost *:80>
    ServerName example.com
    RewriteEngine On
    RewriteCond %{HTTPS} off
    RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [L,R=301]
</VirtualHost>


これにより、すべてのリクエストが自動的にHTTPSにリダイレクトされます。

4. サブディレクトリ単位でのリライト


特定のディレクトリだけmod_rewriteを適用する場合は、<Directory>ブロックで設定します。

<Directory /var/www/html/blog>
    RewriteEngine On
    RewriteRule ^post/([0-9]+)$ /blog/show_post.php?id=$1 [L]
</Directory>


結果:

  • /blog/post/123 というURLが /blog/show_post.php?id=123 にリライトされます。

5. 404エラーページのリダイレクト


存在しないファイルやディレクトリへのアクセスを、カスタム404ページに誘導します。

ErrorDocument 404 /custom_404.html
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /custom_404.html [L]

6. IP制限付きディレクトリ保護


特定のIPアドレスだけが管理画面にアクセスできるように設定します。

<Directory /var/www/html/admin>
    RewriteEngine On
    RewriteCond %{REMOTE_ADDR} !^123\.45\.67\.89$
    RewriteRule ^.*$ - [F]
</Directory>


結果:

  • 123.45.67.89以外のIPアドレスが/adminディレクトリにアクセスしようとすると403エラーになります。

7. 静的コンテンツのキャッシュ制御


静的ファイルに対してキャッシュヘッダーを追加し、パフォーマンスを向上させます。

<FilesMatch "\.(jpg|jpeg|png|gif|css|js|ico)$">
    Header set Cache-Control "max-age=31536000, public"
</FilesMatch>


結果:

  • 静的ファイルのキャッシュが1年間保持され、サーバーの負荷が軽減されます。

これらの設定例を参考に、httpd.confで柔軟なURLリライトを行い、サイトのSEO強化やアクセス制御を効率的に実現してください。次のセクションでは、mod_rewriteの設定全体を振り返り、ポイントをまとめます。

まとめ


本記事では、Apacheのmod_rewriteを活用したURL書き換えの設定方法について解説しました。mod_rewriteの基本概念から、実際のhttpd.confでの設定例、よく使われるリダイレクトや高度なURLリライトの実装例まで幅広く紹介しました。

特に重要なポイントは以下の通りです：

  • mod_rewriteの有効化：a2enmod rewriteやLoadModuleで確実にmod_rewriteを有効にする。
  • 基本的なRewriteRuleとRewriteCondの使い方：正規表現を活用し、柔軟なURL書き換えが可能。
  • 典型的なリダイレクト設定：wwwの有無の統一、HTTPからHTTPSへの強制リダイレクトなど。
  • デバッグとテスト：リダイレクトループや設定ミスを防ぐためにログとテストツールを活用。

mod_rewriteを適切に使いこなすことで、SEO向上やユーザビリティ改善が期待でき、より効率的なWebサイト運営が可能になります。
ぜひ、実際のプロジェクトでこれらのテクニックを活用し、柔軟でメンテナンス性の高い環境を構築してください。

Apache
設定方法 Apache URLリライト mod_rewrite

コメント

コメントする

目次