MENU
  1. ホーム
  2. Apache
  3. Apacheのmod_rewriteでPHPアプリケーションのURLをリライトする方法

Apacheのmod_rewriteでPHPアプリケーションのURLをリライトする方法

Apache

Apacheのmod_rewriteは、WebアプリケーションにおいてURLを自由に変更・リダイレクトする強力なモジュールです。特にPHPアプリケーションでは、動的に生成されるURLをわかりやすく短縮したり、SEO対策として美しいURL構造を実現したりするために活用されます。

例えば、
https://example.com/index.php?page=products
といったURLを
https://example.com/products
のように変換できます。これにより、ユーザーにとっても理解しやすく、検索エンジンの評価も向上します。

本記事では、Apacheでmod_rewriteを有効にし、PHPアプリケーションで実際にURLをリライトする具体的な方法を解説します。基本的なRewriteRuleの記述から、実践的なリライト例、エラー対策まで幅広く紹介します。mod_rewriteを効果的に活用して、よりユーザーフレンドリーなWebアプリケーションを構築しましょう。

目次
  1. mod_rewriteとは何か
    1. mod_rewriteの基本機能
    2. 実際の利用例
  2. URLリライトのメリット
    1. 1. ユーザーフレンドリーなURLの実現
    2. 2. SEO対策の向上
    3. 3. セキュリティの強化
    4. 4. 運用・保守の容易さ
  3. mod_rewriteの有効化方法
    1. 1. mod_rewriteのインストール確認
    2. 2. Apache設定ファイルの編集
    3. 3. Apacheの再起動
    4. 4. 有効化の確認
  4. 基本的なRewriteRuleの記述方法
    1. 1. RewriteRuleの基本構文
    2. 2. クエリパラメータをリライト
    3. 3. リダイレクトの実装
    4. 4. ファイルやディレクトリの存在確認
  5. PHPアプリケーションでのURLリライト実装例
    1. 1. 実装の概要
    2. 2. ディレクトリ構成例
    3. 3. .htaccessの設定
    4. 4. index.phpの実装
    5. 5. products.phpの例
    6. 6. 動作確認
  6. よくあるリライトエラーとその解決方法
    1. 1. 404エラーが発生する
    2. 2. リダイレクトループが発生する
    3. 3. リライトが全く動作しない
    4. 4. 特定のページだけリライトされない
    5. 5. パラメータが正しく渡らない
  7. リダイレクトと内部リライトの使い分け
    1. 1. 内部リライトとは
    2. 2. リダイレクトとは
    3. 3. リダイレクトの種類
    4. 4. 使い分けのポイント
    5. 5. 実装例：旧ページから新ページへ誘導
  8. 複雑なRewriteRuleの記述例と解説
    1. 1. クエリストリングを動的にリライト
    2. 2. 存在しないファイルのみリライト
    3. 3. HTTPとHTTPSのリダイレクト
    4. 4. 特定のIPアドレスだけアクセスを許可
    5. 5. 言語別のリダイレクト
    6. 6. リクエストごとに条件を変更
  9. まとめ

mod_rewriteとは何か


mod_rewriteは、Apache Webサーバーで利用できるモジュールで、リクエストされたURLを別のURLに変換する機能を提供します。これにより、WebサイトのURL構造を柔軟に変更したり、特定の条件に応じて異なるページにリダイレクトさせたりすることが可能になります。

mod_rewriteの基本機能


mod_rewriteは、URLの書き換えを行うことで、次のような機能を実現します。

  • ユーザーフレンドリーなURLの実現：長く複雑なURLを短くわかりやすい形に変更します。
  • 動的URLの静的化：クエリストリングを含む動的URLを、静的なURLに見せかけます。
  • ページ移転時のリダイレクト：旧URLから新URLへリダイレクトすることで、SEOの評価を維持します。

実際の利用例


例えば、次のような動的URLがあるとします。

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


これをmod_rewriteで以下のように変換できます。

https://example.com/about


ユーザーが/aboutにアクセスした際に、サーバー内部ではindex.php?page=aboutが処理されますが、URLとしてはシンプルに表示されます。

このように、mod_rewriteはWebサイトの利便性を高め、SEO対策にも貢献する重要なモジュールです。

URLリライトのメリット

mod_rewriteを活用したURLリライトには、多くの利点があります。特にPHPアプリケーションでは、ユーザー体験の向上やSEO対策として重要な役割を果たします。

1. ユーザーフレンドリーなURLの実現


動的なURLはパラメータが多く、複雑になりがちです。例えば、次のようなURLはユーザーにとって理解しづらいものです。

https://example.com/index.php?page=product&id=25


リライト後は次のようにシンプルになります。

https://example.com/product/25


これにより、視覚的にわかりやすく、直接アクセスしやすくなります。

2. SEO対策の向上


検索エンジンは、シンプルで意味のあるURLを好む傾向があります。クエリストリングを含む動的URLよりも、静的で階層的なURLの方がインデックスされやすくなります。例えば、

https://example.com/blog/seo-tips


のようなURLは、検索結果においてより上位に表示されやすくなります。

3. セキュリティの強化


URLから直接クエリパラメータが見える場合、SQLインジェクションなどの攻撃対象になりやすくなります。リライトによりパラメータを隠すことで、攻撃リスクを低減できます。

4. 運用・保守の容易さ


URL構造を柔軟に変更できるため、ページの移転やリニューアルがあってもリライトルールを修正するだけで済みます。古いURLにアクセスしても新しいページに自動的に誘導できます。

https://example.com/old-page → https://example.com/new-page

mod_rewriteを使うことで、ユーザビリティ、セキュリティ、SEOの全てにおいてメリットが得られます。

mod_rewriteの有効化方法

Apacheでmod_rewriteを利用するには、モジュールを有効化し、適切な設定を行う必要があります。以下では、mod_rewriteを有効化するための具体的な手順を解説します。

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


まず、mod_rewriteがインストールされているか確認します。以下のコマンドでApacheモジュールの一覧を表示します。

apachectl -M


リストの中にrewrite_moduleが含まれていれば、mod_rewriteはすでにインストールされています。含まれていない場合は、以下のコマンドでインストールします。

sudo a2enmod rewrite
sudo systemctl restart apache2

2. Apache設定ファイルの編集


次に、Apacheの設定ファイルを編集してmod_rewriteを有効化します。
/etc/apache2/sites-available/000-default.confなどの設定ファイルを開きます。

sudo nano /etc/apache2/sites-available/000-default.conf


<Directory>ディレクティブ内に以下の記述を追加します。

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


これにより、.htaccessファイルでリライトルールを設定できるようになります。

3. Apacheの再起動


設定を反映するためにApacheを再起動します。

sudo systemctl restart apache2

4. 有効化の確認


mod_rewriteが正しく有効化されているかを確認するには、.htaccessファイルに以下の簡単なリダイレクトルールを記述します。

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


ブラウザでhttps://example.com/testにアクセスし、index.phpが表示されればmod_rewriteが有効になっています。

これでmod_rewriteの準備が整いました。次はRewriteRuleの記述方法について解説していきます。

基本的なRewriteRuleの記述方法

mod_rewriteの中心となるのがRewriteRuleの記述です。これにより、URLを柔軟に書き換えたり、リダイレクトを実行したりできます。ここでは、基本的なRewriteRuleの構文とシンプルな例を紹介します。

1. RewriteRuleの基本構文


RewriteRuleは以下の形式で記述します。

RewriteRule パターン 置換先 [オプション]
  • パターン：リライト対象のURLを正規表現で指定
  • 置換先：リライト後のURLを指定
  • オプション：リダイレクトの種類や動作を制御するフラグ（任意）

例1：シンプルなリライト


以下のRewriteRuleは、/aboutへのアクセスをabout.phpにリライトします。

RewriteEngine On
RewriteRule ^about$ about.php [L]
  • ^about$：aboutというURLパスにマッチ
  • about.php：内部でabout.phpに変換
  • [L]：リライトが完了したら処理を停止（Lastの意味）

2. クエリパラメータをリライト


クエリストリング付きのURLをリライトして、シンプルなURLに変換できます。

RewriteRule ^product/([0-9]+)$ product.php?id=$1 [L]
  • ^product/([0-9]+)$：product/の後に数字が続くURLにマッチ
  • $1：正規表現でキャプチャした数字部分がidとして渡される

アクセス例：

https://example.com/product/25


リライト後：

https://example.com/product.php?id=25

3. リダイレクトの実装


リダイレクトを行う場合はRフラグを使用します。

RewriteRule ^old-page$ /new-page [R=301,L]
  • R=301：301リダイレクト（恒久的）を指定
  • L：リダイレクト後に他のルールを適用しない

アクセス例：

https://example.com/old-page


リダイレクト後：

https://example.com/new-page

4. ファイルやディレクトリの存在確認


存在しないファイルやディレクトリへのアクセスをリライトする場合は、RewriteCondを使用します。

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)$ index.php [L]
  • !-f：存在しないファイルの場合
  • !-d：存在しないディレクトリの場合
  • 全てのアクセスをindex.phpにリライト

このように、mod_rewriteでは柔軟にURLを操作でき、ユーザー体験の向上やSEO対策に貢献します。次はPHPアプリケーションでの具体的なリライト実装について解説します。

PHPアプリケーションでのURLリライト実装例

ここでは、mod_rewriteを使用してPHPアプリケーションで動的なURLを静的でシンプルなURLにリライトする方法を具体的に解説します。

1. 実装の概要


例として、以下のような動的なURLをリライトして、見た目がシンプルなURLに変換します。

元のURL：

https://example.com/index.php?page=products&id=25


リライト後のURL：

https://example.com/products/25

このように、URLのクエリパラメータを隠して、SEOやユーザビリティを向上させます。

2. ディレクトリ構成例

/var/www/html/
│
├── index.php
├── .htaccess
└── pages/
    ├── home.php
    ├── products.php
    └── contact.php


PHPファイルはpagesディレクトリに格納し、URLに応じてindex.phpが適切なページを読み込みます。

3. .htaccessの設定


ルートディレクトリに.htaccessファイルを作成し、以下のリライトルールを記述します。

RewriteEngine On
RewriteBase /
RewriteRule ^products/([0-9]+)$ index.php?page=products&id=$1 [L]
RewriteRule ^contact$ index.php?page=contact [L]
RewriteRule ^$ index.php?page=home [L]
  • products/25にアクセスすると、index.php?page=products&id=25に変換されます。
  • contactへのアクセスはindex.php?page=contactにリライトされます。
  • ルート/にアクセスした場合はindex.php?page=homeが読み込まれます。

4. index.phpの実装


次にindex.phpでリライトされたURLを処理します。

<?php
$page = isset($_GET['page']) ? $_GET['page'] : 'home';
$id = isset($_GET['id']) ? $_GET['id'] : null;

switch ($page) {
    case 'products':
        include 'pages/products.php';
        break;
    case 'contact':
        include 'pages/contact.php';
        break;
    default:
        include 'pages/home.php';
        break;
}
?>
  • $_GET['page']でアクセスされたページを判定し、該当するPHPファイルを読み込みます。
  • productsページでidが指定された場合は、その情報を取得して処理します。

5. products.phpの例


products.phpで商品IDを受け取って表示する例を示します。

<?php
$id = isset($_GET['id']) ? intval($_GET['id']) : 0;
echo "<h1>商品ID: " . htmlspecialchars($id) . "</h1>";
?>
  • 受け取ったidを安全に処理し、商品ページとして表示します。

6. 動作確認


ブラウザで以下のURLにアクセスし、リライトが正しく動作しているか確認します。

https://example.com/products/25
https://example.com/contact
https://example.com/

これで、PHPアプリケーションにおけるURLリライトの基本的な実装が完了です。
次は、よくあるリライトエラーとその解決方法について解説します。

よくあるリライトエラーとその解決方法

mod_rewriteを使用していると、思い通りにURLがリライトされなかったり、リダイレクトループが発生したりすることがあります。ここでは、よくあるエラーとその解決方法を解説します。

1. 404エラーが発生する


原因

  • .htaccessが正しく読み込まれていない
  • RewriteBaseの設定ミス
  • リライト対象のファイルが存在しない

解決方法

  1. .htaccessが有効か確認
sudo apachectl configtest


エラーがない場合は以下を試します。

sudo a2enmod rewrite
sudo systemctl restart apache2
  1. RewriteBaseの設定を修正
    ルートで動作させる場合は、.htaccessに以下を追加します。
RewriteBase /
  1. ファイルの存在を確認
    リライト後のPHPファイルやディレクトリが存在しているか確認します。

2. リダイレクトループが発生する


原因

  • RewriteRuleが無限ループしている
  • 同じリライト条件が複数回実行されている

解決方法

  1. ルールの最後に[L]を付与して処理を停止
RewriteRule ^products/([0-9]+)$ index.php?page=products&id=$1 [L]
  1. ループ回避条件を追加
RewriteCond %{REQUEST_URI} !^/index.php
RewriteRule ^(.*)$ index.php [L]
  • REQUEST_URIを使用して、index.php自身が再度リライトされるのを防ぎます。

3. リライトが全く動作しない


原因

  • AllowOverrideが無効になっている
  • Apacheのキャッシュが残っている

解決方法

  1. AllowOverrideを有効化
    /etc/apache2/sites-available/000-default.confを編集して以下を追加します。
<Directory /var/www/html>
    AllowOverride All
</Directory>


再起動します。

sudo systemctl restart apache2
  1. キャッシュをクリア
    Apacheのキャッシュが原因の場合は、ブラウザキャッシュやApacheのキャッシュをクリアします。

4. 特定のページだけリライトされない


原因

  • 正規表現が間違っている
  • 条件分岐が適切でない

解決方法

  1. 正規表現を確認
    正規表現が意図したURLにマッチしているかを確認します。
RewriteRule ^contact$ index.php?page=contact [L]
  1. デバッグログを有効にする
    Apacheのリライトログを有効にして、詳細なログを確認します。
LogLevel alert rewrite:trace3


ログは以下で確認できます。

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

5. パラメータが正しく渡らない


原因

  • クエリストリングが切り捨てられている

解決方法

  1. クエリストリングを維持するためにQSAフラグを使用します。
RewriteRule ^products/([0-9]+)$ index.php?page=products&id=$1 [L,QSA]

これで、リライトに関する多くのトラブルを未然に防ぎ、問題が発生しても迅速に対処できるようになります。
次は、リダイレクトと内部リライトの違いについて詳しく解説します。

リダイレクトと内部リライトの使い分け

mod_rewriteを使用する際、リダイレクトと内部リライトの違いを理解し、適切に使い分けることが重要です。これにより、SEOの最適化やユーザー体験の向上が図れます。

1. 内部リライトとは


内部リライトは、ユーザーに表示されるURLはそのままに、サーバー内部で別のファイルやスクリプトを処理する方法です。

例：

https://example.com/products/25


内部では以下のように処理されますが、ユーザーには元のURLが表示されます。

https://example.com/index.php?page=products&id=25

.htaccess記述例：

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

メリット：

  • SEOに有効：静的なURLを維持できる
  • ユーザー体験の向上：短くわかりやすいURLを提供
  • ページ遷移が速い：ブラウザのリロードが不要

主な用途：

  • クエリパラメータを隠す
  • 動的ページを静的URLで見せる
  • シンプルなURL構造を維持

2. リダイレクトとは


リダイレクトは、ユーザーが特定のURLにアクセスした際に、別のURLに転送する方法です。転送先のURLがブラウザのアドレスバーに反映されます。

例：

https://example.com/old-page


が

https://example.com/new-page


にリダイレクトされます。

.htaccess記述例：

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

メリット：

  • ページの移転・統合に便利
  • 古いページへのアクセスを新しいページに誘導
  • SEO評価を引き継げる（301リダイレクトの場合）

主な用途：

  • ページの恒久的な移転（301）
  • 一時的な転送（302）
  • ドメインの変更

3. リダイレクトの種類

  • 301リダイレクト（恒久的）
  • SEOで新しいURLに評価が引き継がれる
  • ブラウザや検索エンジンにキャッシュされる
  • 使用例：ページの恒久的な移動
  • 302リダイレクト（一時的）
  • 一時的な転送のため、元のURLに評価が残る
  • 使用例：メンテナンスページへの転送

4. 使い分けのポイント

項目内部リライトリダイレクト
URLの見た目変わらない変わる
ページの移動なしあり
SEOへの影響高い301リダイレクトは高い
主な用途動的URLの静的化ページ移転・ドメイン変更
ブラウザのリロード不要必要

5. 実装例：旧ページから新ページへ誘導

RewriteEngine On
RewriteRule ^old-product/([0-9]+)$ /new-product/$1 [R=301,L]
  • 旧商品のページが新URLに自動でリダイレクトされます。
  • ユーザーは新しいURLをブックマークできます。

内部リライトとリダイレクトを適切に使い分けることで、SEO効果の最大化とユーザー体験の向上が可能です。

複雑なRewriteRuleの記述例と解説

複雑なURLリライトを行う場合、条件分岐や複数のRewriteRuleを組み合わせる必要があります。ここでは、実践的なRewriteRuleの記述例を挙げ、詳細に解説します。

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


クエリパラメータが複数存在するURLを、階層的なURLに変換します。

例：

https://example.com/index.php?category=electronics&product=tv


を

https://example.com/electronics/tv


に変換します。

.htaccess記述例：

RewriteEngine On
RewriteRule ^([a-zA-Z]+)/([a-zA-Z0-9-]+)$ index.php?category=$1&product=$2 [L,QSA]

解説：

  • ^([a-zA-Z]+)/([a-zA-Z0-9-]+)$：
  • 最初の([a-zA-Z]+)でカテゴリ名を取得
  • 2つ目の([a-zA-Z0-9-]+)で商品名を取得
  • index.php?category=$1&product=$2：
  • キャプチャしたカテゴリと商品名がindex.phpに渡されます
  • QSA（Query String Append）：
  • 既存のクエリストリングが保持されます

2. 存在しないファイルのみリライト


アクセスしたURLが存在しない場合にのみリライトを行い、存在するファイルはそのまま処理します。

例：

https://example.com/blog/article123


が存在しない場合は

https://example.com/index.php?page=blog&article=123


にリライトします。

.htaccess記述例：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^blog/([a-zA-Z0-9-]+)$ index.php?page=blog&article=$1 [L]

解説：

  • !-f：存在しないファイルの場合にのみリライト
  • !-d：存在しないディレクトリの場合にリライト
  • ファイルやディレクトリが存在する場合はそのまま処理されます

3. HTTPとHTTPSのリダイレクト


全てのHTTPリクエストをHTTPSにリダイレクトします。

.htaccess記述例：

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

解説：

  • HTTPS !=on：HTTPでアクセスされた場合のみルールが適用されます
  • https://%{HTTP_HOST}%{REQUEST_URI}：元のホスト名とURIが維持されます
  • R=301：恒久的なリダイレクトを行います

4. 特定のIPアドレスだけアクセスを許可


特定のIPアドレス以外からのアクセスをブロックし、403エラーを返します。

.htaccess記述例：

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

解説：

  • REMOTE_ADDR：アクセス元のIPアドレスを取得
  • !^123\.45\.67\.89$：このIPアドレス以外のアクセスを拒否
  • -：リライト先はなし（現在のリクエストが停止）
  • [F]：403 Forbiddenを返します

5. 言語別のリダイレクト


ブラウザの言語設定に応じて、自動的にページをリダイレクトします。

.htaccess記述例：

RewriteEngine On
RewriteCond %{HTTP:Accept-Language} ^ja [NC]
RewriteRule ^$ /ja/index.php [L]
RewriteCond %{HTTP:Accept-Language} ^en [NC]
RewriteRule ^$ /en/index.php [L]

解説：

  • HTTP:Accept-Language：ブラウザの言語設定を取得
  • ^ja：日本語の場合は/ja/index.phpにリダイレクト
  • ^en：英語の場合は/en/index.phpにリダイレクト
  • NC（No Case）：大文字・小文字を区別しません

6. リクエストごとに条件を変更


特定のリファラからのアクセスをブロックし、それ以外はリダイレクトします。

.htaccess記述例：

RewriteEngine On
RewriteCond %{HTTP_REFERER} ^https?://(www\.)?spamdomain\.com [NC]
RewriteRule .* - [F,L]
RewriteRule ^old-page$ /new-page [R=301,L]

解説：

  • HTTP_REFERER：リファラ（参照元）を取得
  • spamdomain.comからのアクセスは403エラー
  • 他のアクセスはold-pageからnew-pageへリダイレクト

これらの記述例を活用して、複雑なURLリライトやセキュリティ対策を実装できます。
次は、記事のまとめとして、リライトの重要なポイントを振り返ります。

まとめ

本記事では、Apacheのmod_rewriteを使ったPHPアプリケーションのURLリライト方法について解説しました。

  • mod_rewriteの基本から始まり、内部リライトとリダイレクトの違い、そして複雑なリライトルールの記述例まで幅広く取り上げました。
  • 実際のPHPアプリケーションでのリライト例を通じて、動的URLを静的でわかりやすいURLに変換する方法を紹介しました。
  • さらに、よくあるエラーとその解決方法、条件分岐やIP制限など、実践的な応用例も提示しました。

mod_rewriteを適切に活用することで、ユーザーエクスペリエンスの向上だけでなく、SEOの強化やセキュリティ対策にも大きく貢献できます。

今後は、自身のプロジェクトでこれらのリライトルールを応用し、より効率的で魅力的なWebサイトを構築していきましょう。

Apache
Apache PHP URLリライト mod_rewrite

コメント

コメントする

目次
  1. mod_rewriteとは何か
    1. mod_rewriteの基本機能
    2. 実際の利用例
  2. URLリライトのメリット
    1. 1. ユーザーフレンドリーなURLの実現
    2. 2. SEO対策の向上
    3. 3. セキュリティの強化
    4. 4. 運用・保守の容易さ
  3. mod_rewriteの有効化方法
    1. 1. mod_rewriteのインストール確認
    2. 2. Apache設定ファイルの編集
    3. 3. Apacheの再起動
    4. 4. 有効化の確認
  4. 基本的なRewriteRuleの記述方法
    1. 1. RewriteRuleの基本構文
    2. 2. クエリパラメータをリライト
    3. 3. リダイレクトの実装
    4. 4. ファイルやディレクトリの存在確認
  5. PHPアプリケーションでのURLリライト実装例
    1. 1. 実装の概要
    2. 2. ディレクトリ構成例
    3. 3. .htaccessの設定
    4. 4. index.phpの実装
    5. 5. products.phpの例
    6. 6. 動作確認
  6. よくあるリライトエラーとその解決方法
    1. 1. 404エラーが発生する
    2. 2. リダイレクトループが発生する
    3. 3. リライトが全く動作しない
    4. 4. 特定のページだけリライトされない
    5. 5. パラメータが正しく渡らない
  7. リダイレクトと内部リライトの使い分け
    1. 1. 内部リライトとは
    2. 2. リダイレクトとは
    3. 3. リダイレクトの種類
    4. 4. 使い分けのポイント
    5. 5. 実装例：旧ページから新ページへ誘導
  8. 複雑なRewriteRuleの記述例と解説
    1. 1. クエリストリングを動的にリライト
    2. 2. 存在しないファイルのみリライト
    3. 3. HTTPとHTTPSのリダイレクト
    4. 4. 特定のIPアドレスだけアクセスを許可
    5. 5. 言語別のリダイレクト
    6. 6. リクエストごとに条件を変更
  9. まとめ