Angular Ansible Apache HTTP Server C C++ CMake CodeIgniter Composer CSS Cypress Dart date-fns Django Django REST Framework Docker Eigen3 ESLint FastAPI Git GNU Make Go HTML htmx HTTP JavaScript jQuery Julia Kotlin LaTeX MariaDB Matplotlib Mongoose Node.js npm NumPy Octave pandas Perl PHP Playwright PostgreSQL Prettier Pygame Python PyTorch Qt R React Native scikit-learn Socket.IO SQLite SVG Tailwind CSS Tcl/Tk TensorFlow Terraform Twig Web APIs webpack

RewriteRule Flags：Apacheで動的なウェブサイトのURLを効率的に管理する方法

2025-06-01

これらのフラグを使うことで、URLの書き換え処理をより柔軟かつ強力に行うことができます。主なフラグには以下のようなものがあります。

  • E=var:value (Environment Variable): このフラグを指定すると、環境変数を設定します。設定された環境変数は、CGIスクリプトやSSI (Server Side Includes) などからアクセスできます。

    RewriteRule ^admin/(.*)$ admin.php?page=$1 [E=ADMIN:true,L]

    /admin/dashboard へのアクセスは admin.php?page=dashboard に書き換えられ、ADMIN という名前の環境変数が true に設定されます。

  • S|skip=num (Skip): このフラグを指定すると、現在のRewriteRuleがマッチした場合、次に続く num 個のRewriteRuleをスキップします。

    RewriteRule ^special\.html$ special.php [S=2]
RewriteRule ^(.*)\.html$ generic.php?page=$1 [L]
RewriteRule ^(.*)$ index.php?page=$1 [L]

    special.html へのアクセスは special.php に書き換えられ、次の2つのルール（.html で終わるURLとそれ以外のURLに対するルール）はスキップされます。

  • QSA (Query String Append): このフラグを指定すると、元のURLのクエリ文字列を置換後のURLに追加します。

    RewriteRule ^article\.php$ view.php [QSA,L]

    article.php?id=123&page=2 へのアクセスは view.php?id=123&page=2 に書き換えられます。QSA がなければ、クエリ文字列は失われます。

  • PT (Pass Through): ApacheのURL処理エンジンに書き換えられたURLを再度渡します。通常、内部的なリクエスト処理（例えば、AliasディレクティブやScriptAliasディレクティブとの連携）で使用されます。

    RewriteRule ^images/(.*)$ /static/images/$1 [PT,L]
Alias /static/ /var/www/static/

    /images/foo.png へのアクセスは /static/images/foo.png に書き換えられ、Aliasディレクティブによって /var/www/static/images/foo.png のファイルが提供されます。

  • NC (No Case): このフラグを指定すると、RewriteRuleのパターンマッチングで大文字・小文字を区別しなくなります。

    RewriteRule ^product/ABC$ item.php?id=123 [NC,L]

    product/abc、product/Abc、PRODUCT/ABC など、大文字・小文字が異なってもこのルールが適用されます。

  • R (Redirect): このフラグを指定すると、HTTPリダイレクトを行います。デフォルトでは一時的なリダイレクト (302 Found) です。恒久的なリダイレクト (301 Moved Permanently) を行いたい場合は、R=301 のようにステータスコードを指定します。

    RewriteRule ^old-site/(.*)$ https://new-site.com/$1 [R=301,L]

    old-site 以下のURLへのアクセスは、new-site.com の対応するURLへ恒久的にリダイレクトされます。

  • L (Last): このフラグを指定すると、現在のRewriteRuleが処理された後、それ以降のRewriteRuleの処理を停止します。多くの場合、最後のRewriteRuleに指定されます。

    例:

    RewriteRule ^old\.html$ new.html [L]
RewriteRule ^(.*)$ index.php?page=$1 [L]

    old.html へのアクセスは new.html に書き換えられ、それ以降のルールは処理されません。

これらはRewriteRuleでよく使われるフラグのほんの一部です。他にも様々なフラグがあり、Apacheのドキュメントで詳細を確認することができます。


一般的なエラーとトラブルシューティング

    • 原因
      R (Redirect) フラグを使用している場合に、リダイレクトの条件が適切に設定されていないと、サーバーが自身に何度もリダイレクトを繰り返してしまうことがあります。例えば、特定のリクエストに対して常にリダイレクトするようなルールを設定してしまうと発生します。
    • トラブルシューティング
      • RewriteRuleのパターンと置換文字列、そしてリダイレクトの条件を慎重に確認してください。
      • リダイレクトが発生する条件をより具体的にする必要があります。
      • ブラウザのキャッシュをクリアして、古いリダイレクト設定が残っていないか確認してください。
      • Apacheの設定ファイル (.htaccess や httpd.conf) を確認し、関連するRewriteRuleやRewriteCondディレクティブを見直してください。

  2. RewriteRuleが期待通りに動作しない (書き換えられない)

    • 原因
      • RewriteRuleのパターンが意図したURLとマッチしていない。正規表現の記述ミスなどが考えられます。
      • フラグの組み合わせが適切でない。例えば、L フラグが早すぎる位置に記述されていると、後続のルールが処理されません。
      • NC (No Case) フラグの有無によって、大文字・小文字の区別が影響している。
      • RewriteCondディレクティブの条件が期待通りに評価されていない。
    • トラブルシューティング
      • RewriteRuleのパターンをテストツールなどで検証し、意図したURLとマッチするか確認してください。
      • フラグの順序や組み合わせを見直し、L フラグの位置が適切か確認してください。
      • 大文字・小文字を区別する必要があるか、NC フラグの適用範囲が適切か検討してください。
      • RewriteLog を有効にして、RewriteRuleとRewriteCondの処理過程を確認してください。RewriteLogの設定例：RewriteLog "/var/log/apache2/rewrite.log"、RewriteLogLevel 3 (LogLevelは調整してください)。ログファイルを確認することで、どのルールがマッチし、どのように処理されているかを確認できます。
      • .htaccess ファイルを使用している場合は、Apacheの設定で AllowOverride All が設定されているか確認してください。これが設定されていないと、.htaccess のRewrite関連のディレクティブは無視されます。

  3. クエリ文字列が失われる

    • 原因
      QSA (Query String Append) フラグを指定せずにURLを書き換えると、元のURLのクエリ文字列が失われてしまいます。
    • トラブルシューティング
      クエリ文字列を保持したい場合は、RewriteRuleに [QSA] フラグを追加してください。

  4. 内部サーバーエラー (500 Internal Server Error)

    • 原因
      .htaccess ファイルの文法エラーや、RewriteRule、RewriteCondディレクティブの記述ミスなど、Apacheの設定ファイルに不正な記述があると発生することがあります。
    • トラブルシューティング
      • Apacheのエラーログ (error.log) を確認し、具体的なエラーメッセージを特定してください。
      • .htaccess ファイルを編集した場合は、文法ミスがないか慎重に確認してください。記述を一つずつ確認するか、問題が発生する前の状態に戻して動作確認を行うと良いでしょう。
      • 不要なRewriteRuleやRewriteCondを一時的にコメントアウトして、問題の箇所を特定するのも有効です。

  5. PT (Pass Through) フラグの誤用

    • 原因
      PT フラグは、Apacheの内部処理に書き換えられたURLを再度渡すためのものですが、これを不適切に使用すると、予期しない内部リクエストが発生したり、処理がループしたりする可能性があります。
    • トラブルシューティング
      PT フラグの使用目的を理解し、AliasやScriptAliasディレクティブとの連携など、本当に必要な場合にのみ使用してください。

トラブルシューティングのヒント

  • サーバー再起動
    .htaccess ファイルの変更は通常すぐに反映されますが、httpd.conf などの設定ファイルを変更した場合は、Apacheサーバーの再起動が必要になることがあります。
  • オンラインツール
    正規表現のテストツールや、.htaccess ファイルの構文チェッカーなどを活用するのも有効です。
  • ドキュメント参照
    Apacheの公式ドキュメントで、各フラグの動作や注意点を確認してください。
  • コメントアウト
    問題が発生していると思われるRewriteRuleやRewriteCondを一時的にコメントアウトして、他のルールの動作を確認します。
  • 段階的なテスト
    複雑なRewriteRuleを設定する場合は、一度に全てを記述するのではなく、簡単なルールから段階的にテストしていくことをお勧めします。

L (Last) フラグの例

このフラグは、現在のルールが処理されたらそれ以降のルールの処理を停止します。

# /var/www/example.com/.htaccess

# old.html へのアクセスを new.html に書き換え、処理を終了
RewriteRule ^old\.html$ new.html [L]

# もし上記ルールにマッチしなかった場合、すべてのリクエストを index.php に転送
RewriteRule ^(.*)$ index.php?page=$1 [L]

この例では、old.html へのアクセスは new.html に書き換えられ、2番目のルールは処理されません。一方、old.html 以外のファイルへのアクセス（例えば about.html）は最初のルールにマッチしないため、2番目のルールが適用され、index.php?page=about.html として処理されます。

R (Redirect) フラグの例

このフラグは、HTTPリダイレクトを行います。ステータスコードを指定しない場合は一時的なリダイレクト (302) になります。恒久的なリダイレクト (301) を行う場合は R=301 と記述します。

# /var/www/example.com/.htaccess

# http://example.com/old-page を https://example.com/new-page へ恒久的にリダイレクト
RewriteRule ^old-page$ https://example.com/new-page [R=301,L]

# http://example.com/old-domain/(...) を https://new-domain.com/(...) へ一時的にリダイレクト
RewriteRule ^old-domain/(.*)$ https://new-domain.com/$1 [R,L]

最初のルールは、古いページへのアクセスを新しいページへ恒久的にリダイレクトします。2番目のルールは、古いドメイン以下のすべてのパスを新しいドメインの同じパスへ一時的にリダイレクトします。

NC (No Case) フラグの例

このフラグは、パターンマッチングで大文字・小文字を区別しないようにします。

# /var/www/example.com/.htaccess

# /product/ABC、/product/abc、/product/Abc など、大文字・小文字を区別せずに item.php?id=123 に書き換え
RewriteRule ^product/abc$ item.php?id=123 [NC,L]

このルールは、product/ の後に続く文字列が abc であれば、大文字・小文字に関わらず item.php?id=123 に書き換えます。

PT (Pass Through) フラグの例

このフラグは、書き換えられたURLをApacheの次の処理エンジンに渡します。CGIスクリプトやAliasディレクティブと連携する場合などに使用されます。

# /etc/apache2/sites-available/example.com.conf (VirtualHost 内)

# /images/ ディレクトリへのアクセスを /static-images/ ディレクトリのスクリプトで処理
RewriteRule ^/images/(.*)$ /static-images/process_image.php/$1 [PT,L]

# /static-images/ を実際のファイルシステム上のパスにマウント
Alias /static-images/ /var/www/static/

この例では、/images/image.jpg へのアクセスは /static-images/process_image.php/image.jpg に書き換えられ、PT フラグによってこの書き換えられたURLがさらに処理されます。Alias ディレクティブによって /static-images/ が /var/www/static/ にマウントされているため、最終的に /var/www/static/process_image.php/image.jpg が実行されることになります。

QSA (Query String Append) フラグの例

このフラグは、元のURLのクエリ文字列を書き換え後のURLに追加します。

# /var/www/example.com/.htaccess

# article.php へのアクセスを view.php に書き換え、元のクエリ文字列を引き継ぐ
RewriteRule ^article\.php$ view.php [QSA,L]

例えば、article.php?id=123&page=2 にアクセスした場合、このルールによって view.php?id=123&page=2 として処理されます。QSA フラグがない場合、クエリ文字列 (id=123&page=2) は失われます。

S|skip=num (Skip) フラグの例

このフラグは、現在のルールがマッチした場合、次に続く num 個のルールをスキップします。

# /var/www/example.com/.htaccess

# special.html へのアクセスは special.php で処理し、次の2つのルールをスキップ
RewriteRule ^special\.html$ special.php [S=2]

# .html で終わるファイルへのアクセスは generic.php で処理
RewriteRule ^(.*)\.html$ generic.php?page=$1 [L]

# それ以外のすべてのリクエストは index.php で処理
RewriteRule ^(.*)$ index.php?page=$1 [L]

special.html にアクセスすると、最初のルールがマッチし、special.php が実行されます。[S=2] フラグによって、次の2つのルール（.html で終わるファイルとそれ以外のすべてのリクエストに対するルール）はスキップされます。about.html にアクセスした場合は、最初のルールはマッチせず、2番目のルールがマッチして generic.php?page=about が実行され、[L] フラグによって処理が終了します。

E=var:value (Environment Variable) フラグの例

このフラグは、サーバーの環境変数を設定します。これは、CGIスクリプトやPHPなどでアクセスできます。

# /var/www/example.com/.htaccess

# /admin/ へのアクセスの場合、環境変数 ADMIN を true に設定
RewriteRule ^admin/(.*)$ admin.php?page=$1 [E=ADMIN:true,L]

このルールが適用されると、admin.php スクリプト内などで $_SERVER['ADMIN'] を参照することで、このリクエストが /admin/ 以下へのアクセスであることが判別できます。


mod_alias モジュール

mod_alias モジュールは、URLをファイルシステムの特定の場所にマッピングしたり、外部のURLへリダイレクトしたりするためのディレクティブを提供します。RewriteRuleほど柔軟なパターンマッチングはできませんが、単純なURLのリダイレクトやエイリアスの設定には適しています。

  • Redirect ディレクティブ
    あるURLを別のURLへリダイレクトします。RewriteRule の R フラグと同様の機能を提供しますが、より単純な構文で使用できます。

    # /etc/apache2/sites-available/example.com.conf (VirtualHost 内)
# 一時的なリダイレクト (302)
Redirect /old-page /new-page

# 恒久的なリダイレクト (301)
Redirect permanent /old-domain/ https://new-domain.com/

    Redirect ディレクティブは、正規表現による複雑なパターンマッチングはできませんが、単純なリダイレクト設定には便利です。

  • Alias ディレクティブ
    特定のURLパスをファイルシステムのローカルディレクトリにマッピングします。RewriteRuleの PT フラグと似たような内部的なリクエスト処理に使えます。

    # /etc/apache2/sites-available/example.com.conf (VirtualHost 内)
Alias /images/ /var/www/static/images/

    この例では、/images/ で始まるURLへのリクエストは、実際にはサーバーの /var/www/static/images/ ディレクトリからファイルが提供されます。RewriteRuleのように書き換えは行われませんが、URLとファイルシステムの対応付けを実現できます。

プログラミング言語による処理 (PHP, Python, etc.)

ApacheのRewrite機能に頼るのではなく、PHP、Python、Node.jsなどのバックエンドのプログラミング言語でURLの解析と処理を行う方法があります。

  • ルーティングライブラリ/フレームワーク
    多くのWebフレームワーク（例: Laravel (PHP), Django (Python), Express (Node.js)）は、高度なルーティング機能を提供しています。これらのフレームワーク内でURLパターンを定義し、それに対応する処理関数を記述することで、RewriteRuleと同様のURL操作やリクエスト処理を実現できます。

    PHP (Laravel の例)

    // routes/web.php

Route::get('old-url', function () {
    return redirect('new-url', 301);
});

Route::get('users/{id}', 'UserController@show');

    フレームワークのルーティング機能を使うと、より構造化された方法でURLと処理を関連付けることができます。RewriteRuleよりもコードの可読性や保守性が向上する場合があります。

mod_rewrite のより高度な機能

RewriteRuleフラグの代替というわけではありませんが、mod_rewrite 自体が持つより高度な機能を利用することで、フラグだけでは実現できない複雑な処理を行うことができます。

  • RewriteMap ディレクティブ
    大量のURL書き換えルールを外部ファイルに定義し、それを参照することができます。これにより、設定ファイルの肥大化を防ぎ、管理を容易にすることができます。

    # /etc/apache2/httpd.conf
RewriteMap lowercase int:tolower

# .htaccess
RewriteRule ^([A-Z]+)$ ${lowercase:$1} [L]

    この例では、RewriteMapを使ってURLを小文字に変換しています。

  • RewriteCond ディレクティブ
    RewriteRuleの適用条件をより細かく指定できます。HTTPヘッダー、環境変数、サーバー変数などに基づいて条件を設定できます。

    RewriteCond %{HTTP_USER_AGENT} iPhone [NC]
RewriteRule ^(.*)$ /iphone/$1 [L]

RewriteCond %{HTTP_REFERER} !^$
RewriteCond %{HTTP_REFERER} !^https?://(www\.)?example\.com [NC]
RewriteRule \.(jpg|jpeg|png|gif)$ - [F,L] # 他サイトからの画像直接リンクを禁止

    RewriteCond を使うことで、特定の条件を満たすリクエストに対してのみRewriteRuleを適用できます。

  • mod_rewrite の高度な機能 (RewriteCond, RewriteMap)
    RewriteRuleフラグだけでは実現できない、より複雑な条件に基づいた書き換えや、大規模な書き換えルールを効率的に管理したい場合に有効です。
  • プログラミング言語による処理
    より複雑なルーティングロジックや、動的なコンテンツに基づいたURL処理が必要な場合に適しています。フレームワークのルーティング機能を利用すると、開発効率や保守性が向上します。
  • mod_alias
    単純なURLとファイルシステムの対応付けや、基本的なリダイレクトに適しています。正規表現の知識がなくても比較的簡単に設定できます。