Google Git
Sign in
apache/httpd/refs/heads/trunk/./docs/manual/rewrite/flags.html.ja.utf8
blob: b2bb5a17d99147a8d5040dbb3b5d1909465cd8d9 [file]
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="ja"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>RewriteRule フラグ - Apache HTTP サーバ バージョン 2.5</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/quickreference.html">ディレクティブ</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.5</p>
<img alt="" src="../images/feather.png"></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> &gt; <a href="https://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="https://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="../">バージョン 2.5</a> &gt; <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>RewriteRule フラグ</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../de/rewrite/flags.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/rewrite/flags.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/rewrite/flags.html" hreflang="es" rel="alternate" title="Espa&ntilde;ol">&nbsp;es&nbsp;</a> |
<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="../ja/rewrite/flags.html" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/rewrite/flags.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../tr/rewrite/flags.html" hreflang="tr" rel="alternate" title="T&uuml;rk&ccedil;e">&nbsp;tr&nbsp;</a> |
<a href="../zh-cn/rewrite/flags.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>このドキュメントでは、<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
ディレクティブで使用可能なフラグについて、詳細な説明と例を提供します。</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif"> <a href="#introduction">はじめに</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_b">B (バックリファレンスのエスケープ)</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_bnp">BNP|backrefnoplus (スペースを + にエスケープしない)</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_bctls">BCTLS</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_bne">BNE</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_c">C|chain</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_co">CO|cookie</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_dpi">DPI|discardpath</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_e">E|env</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_end">END</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_f">F|forbidden</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_g">G|gone</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_h">H|handler</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_l">L|last</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_n">N|next</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_nc">NC|nocase</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_ne">NE|noescape</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_ns">NS|nosubreq</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_p">P|proxy</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_pt">PT|passthrough</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_qsa">QSA|qsappend</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_qsd">QSD|qsdiscard</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_qsl">QSL|qslast</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_r">R|redirect</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_s">S|skip</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_t">T|type</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_unsafe_allow_3f">UnsafeAllow3F</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_unsafe_prefix_stat">UnsafePrefixStat</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#flag_unc">UNC</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">モジュールドキュメント</a></li><li><a href="intro.html">mod_rewrite 入門</a></li><li><a href="remapping.html">リダイレクトとリマッピング</a></li><li><a href="access.html">アクセス制御</a></li><li><a href="vhosts.html">バーチャルホスト</a></li><li><a href="proxy.html">プロキシ</a></li><li><a href="rewritemap.html">RewriteMap の使用</a></li><li><a href="advanced.html">高度なテクニック</a></li><li><a href="avoid.html">mod_rewrite を使わない場合</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="introduction">はじめに <a title="Permanent link" href="#introduction" class="permalink">&para;</a></h2>
<p><code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> は、
1 つ以上のフラグによって動作を変更できます。フラグはルールの末尾の
角括弧内に含まれ、複数のフラグはカンマで区切られます。</p>
<pre class="prettyprint lang-config">RewriteRule pattern target [Flag1,Flag2,Flag3]</pre>
<p>各フラグ (いくつかの例外を除き) には <code>CO</code> のような短い形式と、
<code>cookie</code> のような長い形式があります。短い形式を使用するのが
最も一般的ですが、各フラグの機能を覚えるために長い形式に慣れることを
お勧めします。一部のフラグは 1 つ以上の引数を取ります。フラグは
大文字小文字を区別しません。</p>
<p>メタデータを変更するフラグ (T=、H=、E=) は、ディレクトリ単位および
htaccess コンテキストで、同じ書き換え処理ラウンド中に ('-' 以外の)
置換が行われる場合、効果がありません。</p>
<p>ここでは、各フラグと使用例を紹介します。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_b">B (バックリファレンスのエスケープ) <a title="Permanent link" href="#flag_b" class="permalink">&para;</a></h2>
<p>[B] フラグは、変換を適用する前に非英数字文字をエスケープするよう
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> に指示します。</p>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> はマッピング前に URL をアンエスケープする
必要があるため、バックリファレンスは適用時にアンエスケープされています。
B フラグを使用すると、バックリファレンス内の非英数字文字がエスケープ
されます。例えば、以下のルールを考えてみてください:</p>
<p>サーバ変数の同様のエスケープについては、"escape"
<a href="#mapfunc">マッピング関数</a>を参照してください</p>
<pre class="prettyprint lang-config">RewriteRule "^search/(.*)$" "/search.php?term=$1"</pre>
<p>検索語が 'x &amp; y/z' の場合、ブラウザはこれを
'x%20%26%20y%2Fz' としてエンコードし、リクエストは 'search/x%20%26%20y%2Fz'
になります。B フラグがない場合、この書き換えルールは 'search.php?term=x &amp; y/z'
にマッピングされますが、これは有効な URL ではないため、
<code>search.php?term=x%20&amp;y%2Fz=</code> としてエンコードされ、
意図した結果になりません。</p>
<p>同じルールに B フラグを設定すると、パラメータは出力 URL に渡される前に
再エンコードされ、正しいマッピング
<code>/search.php?term=x%20%26%20y%2Fz</code> になります。</p>
<pre class="prettyprint lang-config">RewriteRule "^search/(.*)$" "/search.php?term=$1" [B,PT]</pre>
<p>この特定の例を動作させるには、<code class="directive"><a href="../mod/core.html#allowencodedslashes">AllowEncodedSlashes</a></code> を <code>On</code> に
設定する必要がある場合があることに注意してください。httpd は URL 内の
エンコードされたスラッシュを許可せず、見つけた場合は 404 を返します。</p>
<p>このエスケープは特にプロキシの状況で必要です。バックエンドが
アンエスケープされた URL を受け取ると壊れる可能性があるためです。</p>
<p>このフラグの代替として、<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> を使用して %{THE_REQUEST} に対してキャプチャする
方法があります。これはエンコードされた形式の文字列をキャプチャします。</p>
<p>2.4.26 以降では、エスケープする文字を特定の文字に限定できます:
<code>[B=#?;]</code>。注: スペース文字はエスケープする文字リストに
含めることができますが、<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
の 3 番目の引数全体を引用符で囲む必要があり、スペースはリストの
最後の文字にしてはいけません。</p>
<pre class="prettyprint lang-config"># スペースと疑問符をエスケープ。最後の引数の引用符は
# スペースが含まれる場合に必要です。
RewriteRule "^search/(.*)$" "/search.php?term=$1" "[B= ?]"</pre>
<p>この方法でエスケープされる文字を制限するには、<a href="#flag_bne">#flag_bne</a>
および <a href="#flag_bctls">#flag_bctls</a> を参照してください</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_bnp">BNP|backrefnoplus (スペースを + にエスケープしない) <a title="Permanent link" href="#flag_bnp" class="permalink">&para;</a></h2>
<p>[BNP] フラグは、バックリファレンス内のスペース文字を '+' ではなく
%20 にエスケープするよう <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> に指示します。
バックリファレンスがクエリ文字列ではなくパスコンポーネントで使用される
場合に便利です。</p>
<pre class="prettyprint lang-config"># クエリ文字列経由のフォーム送信で使用される + ではなく、
# パス内のスペースを %20 にエスケープ
RewriteRule "^search/(.*)$" "/search.php/$1" "[B,BNP]"</pre>
<p>このフラグはバージョン 2.4.26 以降で使用可能です。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_bctls">BCTLS <a title="Permanent link" href="#flag_bctls" class="permalink">&para;</a></h2>
<p>[BCTLS] フラグは [B] フラグに似ていますが、制御文字とスペース文字のみを
エスケープします。これは、エンコードされずにクエリ文字列にコピーされた
場合に拒否される文字セットと同じです。</p>
<pre class="prettyprint lang-config"># 制御文字とスペースをエスケープ
RewriteRule "^search/(.*)$" "/search.php/$1" "[BCTLS]"</pre>
<p>このフラグはバージョン 2.5.1 以降で使用可能です。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_bne">BNE <a title="Permanent link" href="#flag_bne" class="permalink">&para;</a></h2>
<p>[BNE=...] 内の文字リストは、[B] または [BCTLS] フラグの文字に対する
除外として扱われます。リストされた文字はエスケープされません。</p>
<pre class="prettyprint lang-config"># デフォルトの文字をエスケープするが、/ は除外
RewriteRule "^search/(.*)$" "/search.php?term=$1" "[B,BNE=/]"</pre>
<p>このフラグはバージョン 2.5.1 以降で使用可能です。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_c">C|chain <a title="Permanent link" href="#flag_c" class="permalink">&para;</a></h2>
<p>[C] または [chain] フラグは、<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> が次のルールに
チェーンされることを示します。つまり、ルールがマッチすると通常通り
処理され、制御は次のルールに移ります。しかし、マッチしない場合は、
次のルールおよびチェーンされたその他のルールがスキップされます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_co">CO|cookie <a title="Permanent link" href="#flag_co" class="permalink">&para;</a></h2>
<p>[CO] または [cookie] フラグは、特定の
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> がマッチした場合に
cookie を設定できるようにします。引数は 3 つの必須フィールドと
5 つのオプションフィールドで構成されます。</p>
<p>フラグの完全な構文 (すべての属性を含む) は以下の通りです:</p>
<div class="example"><p><code>
[CO=NAME:VALUE:DOMAIN:lifetime:path:secure:httponly:samesite]
</code></p></div>
<p>cookie フィールドのいずれかにリテラルの ':' 文字が必要な場合、
代替構文が利用可能です。代替構文にオプトインするには、cookie の
"Name" の前に ';' 文字を付け、フィールドセパレータを ';' として
指定してください。</p>
<div class="example"><p><code>
[CO=;NAME;VALUE:MOREVALUE;DOMAIN;lifetime;path;secure;httponly;samesite]
</code></p></div>
<p>cookie が設定されるためには、名前、値、およびドメインを宣言する
必要があります。</p>
<dl>
<dt>Domain</dt>
<dd>cookie が有効なドメインです。<code>www.example.com</code> のような
ホスト名か、<code>.example.com</code> のようなドメインです。
ドットで区切られた少なくとも 2 つのパートが必要です。つまり、
単に <code>.com</code> や <code>.net</code> にはできません。
そのような cookie は cookie セキュリティモデルで禁止されています。</dd>
</dl>
<p>オプションで以下の値も設定できます:</p>
<dl>
<dt>Lifetime</dt>
<dd>cookie が保持される時間 (分単位)。</dd>
<dd>値が 0 の場合、cookie は現在のブラウザセッションの間のみ保持されます。
指定されない場合のデフォルト値です。</dd>
<dd>負の値を指定すると、ブラウザで cookie が削除されます。</dd>
<dt>Path</dt>
<dd>cookie が有効な現在のウェブサイトのパスです。
<code>/customers/</code> や <code>/files/download/</code> などです。</dd>
<dd>デフォルトでは <code>/</code> (ウェブサイト全体) に設定されます。</dd>
<dt>Secure</dt>
<dd><code>secure</code>、<code>true</code>、または <code>1</code> に
設定すると、cookie はセキュアな (https) 接続経由でのみ送信が許可されます。</dd>
<dt>httponly</dt>
<dd><code>HttpOnly</code>、<code>true</code>、または <code>1</code> に
設定すると、cookie に <code>HttpOnly</code> フラグが設定され、
この機能をサポートするブラウザでは JavaScript コードから cookie に
アクセスできなくなります。</dd>
<dt>samesite</dt>
<dd><code>false</code> または <code>0</code> 以外の値に設定すると、
<code>SameSite</code> 属性が指定された値に設定されます。典型的な値は
<code>None</code>、<code>Lax</code>、<code>Strict</code> です。
2.5.1 以降で使用可能です。</dd>
</dl>
<p>以下の例を考えてみましょう:</p>
<pre class="prettyprint lang-config">RewriteEngine On
RewriteRule "^/index\.html" "-" [CO=frontdoor:yes:.example.com:1440:/]</pre>
<p>この例では、ルールはリクエストを書き換えません。
書き換えターゲットの "-" は <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> にリクエストを
変更せずに通過させることを意味します。代わりに、'frontdoor' という名前で
値 'yes' の cookie を設定します。cookie は <code>.example.com</code>
ドメイン内のすべてのホストに対して有効です。有効期限は 1440 分
(24 時間) で、すべての URI に対して返されます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_dpi">DPI|discardpath <a title="Permanent link" href="#flag_dpi" class="permalink">&para;</a></h2>
<p>DPI フラグは、書き換えた URI の PATH_INFO 部分を破棄します。</p>
<p>このフラグはバージョン 2.2.12 以降で使用可能です。</p>
<p>ディレクトリ単位のコンテキストでは、各
<code class="directive">RewriteRule</code> が比較する URI は、URI と PATH_INFO の
現在の値を連結したものです。</p>
<p>現在の URI は、クライアントが要求した初期 URI、
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> の前のラウンドの処理結果、または現在のラウンドの
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> 処理の前のルールの結果である可能性があります。</p>
<p>一方、各ルールの前に URI に追加される PATH_INFO は、この
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> 処理ラウンド前の PATH_INFO の値のみを
反映します。その結果、URI の大部分が複数の
<code class="directive">RewriteRule</code> ディレクティブで置換にマッチおよび
コピーされ、URI のどの部分が現在の PATH_INFO から来たかを考慮しない場合、
最終的な URI に PATH_INFO の複数のコピーが追加される可能性があります。</p>
<p>前のマッピングの結果としてのこのリクエストの PATH_INFO が不要な
置換にはこのフラグを使用してください。このフラグは、この
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> 処理ラウンドの開始前に確立された PATH_INFO を
永続的に破棄します。PATH_INFO は、現在の <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
処理ラウンドが完了するまで再計算されません。このラウンド中の
後続のルールは、PATH_INFO が追加されていない置換の直接の結果のみを
参照します。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_e">E|env <a title="Permanent link" href="#flag_e" class="permalink">&para;</a></h2>
<p>[E] または [env] フラグを使用すると、環境変数の値を設定できます。
一部の環境変数はルールの実行後に設定される可能性があり、設定した値が
上書きされることがあることに注意してください。環境変数の動作の詳細は
<a href="../env.html">環境変数ドキュメント</a>を参照してください。</p>
<p>このフラグの完全な構文は以下の通りです:</p>
<pre class="prettyprint lang-config">[E=VAR:VAL]
[E=!VAR]</pre>
<p><code>VAL</code> には展開されるバックリファレンス (<code>$N</code> や
<code>%N</code>) を含めることができます。</p>
<p>短い形式</p>
<div class="example"><p><code>
[E=VAR]
</code></p></div>
<p>を使用すると、<code>VAR</code> という名前の環境変数を空の値に
設定できます。</p>
<p>以下の形式</p>
<div class="example"><p><code>
[E=!VAR]
</code></p></div>
<p>で、以前に設定された <code>VAR</code> という名前の環境変数を
削除できます。</p>
<p>環境変数は CGI プログラム、他の RewriteRule ディレクティブ、
CustomLog ディレクティブなど、さまざまなコンテキストで使用できます。</p>
<p>以下の例は、リクエストされた URI が画像ファイルの場合、'image' という
環境変数を値 '1' に設定します。その後、その環境変数を使用して、
それらのリクエストをアクセスログから除外します。</p>
<pre class="prettyprint lang-config">RewriteRule "\.(png|gif|jpg)$" "-" [E=image:1]
CustomLog "logs/access_log" combined env=!image</pre>
<p>この効果は <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> を
使用しても得られることに注意してください。このテクニックは推奨としてではなく、
例として提供されています。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_end">END <a title="Permanent link" href="#flag_end" class="permalink">&para;</a></h2>
<p>[END] フラグを使用すると、([L] のように) 現在の書き換え処理ラウンドを
終了するだけでなく、ディレクトリ単位 (htaccess) コンテキストでの
以降の書き換え処理も防止します。</p>
<p>これは外部リダイレクトによる新しいリクエストには適用されません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_f">F|forbidden <a title="Permanent link" href="#flag_f" class="permalink">&para;</a></h2>
<p>[F] フラグを使用すると、サーバはクライアントに 403 Forbidden
ステータスコードを返します。同じ動作は
<code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> ディレクティブでも
実現できますが、このフラグの方が Forbidden ステータスの割り当てに
柔軟性があります。</p>
<p>以下のルールは、サーバから <code>.exe</code> ファイルのダウンロードを
禁止します。</p>
<pre class="prettyprint lang-config">RewriteRule "\.exe" "-" [F]</pre>
<p>この例は書き換えターゲットに "-" 構文を使用しており、リクエスト URI は
変更されません。リクエストを禁止するのであれば、別の URI に書き換える
理由はありません。</p>
<p>[F] を使用すると [L] が暗黙的に含まれます - つまり、レスポンスが
直ちに返され、後続のルールは評価されません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_g">G|gone <a title="Permanent link" href="#flag_g" class="permalink">&para;</a></h2>
<p>[G] フラグは、サーバにレスポンスとして 410 Gone ステータスを
返すよう強制します。これは、リソースがかつて利用可能であったが、
もはや利用できないことを示します。</p>
<p>[F] フラグと同様に、[G] フラグを使用する場合は通常書き換えターゲットに
"-" 構文を使用します:</p>
<pre class="prettyprint lang-config">RewriteRule "oldproduct" "-" [G,NC]</pre>
<p>[G] を使用すると [L] が暗黙的に含まれます - つまり、レスポンスが
直ちに返され、後続のルールは評価されません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_h">H|handler <a title="Permanent link" href="#flag_h" class="permalink">&para;</a></h2>
<p>結果のリクエストを指定されたハンドラで処理するよう強制します。
例えば、ファイル拡張子のないすべてのファイルを php ハンドラで
解析させるために使用できます:</p>
<pre class="prettyprint lang-config">RewriteRule "!\." "-" [H=application/x-httpd-php]</pre>
<p>
上記の正規表現 - <code>!\.</code> - は、リテラルの <code>.</code>
文字を含まないすべてのリクエストにマッチします。
</p>
<p>これは条件に基づいてハンドラを強制するためにも使用できます。
例えば、以下のスニペットをサーバ単位のコンテキストで使用すると、
<code>.php</code> ファイルが <code>.phps</code> 拡張子でリクエスト
された場合に <code>mod_php</code> によって<em>表示</em>されます:</p>
<pre class="prettyprint lang-config">RewriteRule "^(/source/.+\.php)s$" "$1" [H=application/x-httpd-php-source]</pre>
<p>上記の正規表現 - <code>^(/source/.+\.php)s$</code> - は
<code>/source/</code> で始まり、1 文字以上の任意の文字が続き、
リテラルの <code>.phps</code> で終わるリクエストにマッチします。
バックリファレンス $1 は正規表現の括弧内のキャプチャされたマッチを
参照します。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_l">L|last <a title="Permanent link" href="#flag_l" class="permalink">&para;</a></h2>
<p>[L] フラグは <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> にルールセットの処理を
停止させます。ほとんどのコンテキストで、ルールがマッチした場合、
以降のルールは処理されなくなります。これは Perl の <code>last</code>
コマンドや C の <code>break</code> コマンドに相当します。
このフラグは、後続のルールを考慮せずに現在のルールを直ちに適用
すべきことを示すために使用します。</p>
<p><code>.htaccess</code> ファイルまたは
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>
セクションで <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
を使用している場合、ルールがどのように処理されるかについてある程度の
理解が重要です。簡略化すると、ルールが処理された後、書き換えられた
リクエストは URL 解析エンジンに渡されます。書き換えられたリクエストが
処理される際に、<code>.htaccess</code> ファイルまたは
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> セクションが
再び検出され、ルールセットが最初から再実行される可能性があります。
これは最も一般的に、ルールの 1 つが (内部または外部の) リダイレクトを
引き起こし、リクエスト処理が最初からやり直される場合に発生します。</p>
<p>したがって、これらのコンテキストで <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> ディレクティブを使用する場合、
ルールのループを避けるための明示的な対策を取り、一連のルールの実行
終了を [L] フラグだけに頼らないことが重要です。以下に示す通りです。</p>
<p>代替フラグ [END] は、現在の書き換え処理ラウンドを終了するだけでなく、
ディレクトリ単位 (htaccess) コンテキストでの以降の書き換え処理も
防止するために使用できます。これは外部リダイレクトによる新しい
リクエストには適用されません。</p>
<p>ここに示す例は、すべてのリクエストを <code>index.php</code> に
書き換え、元のリクエストを <code>index.php</code> へのクエリ文字列
引数として渡しますが、<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
により、リクエストが既に <code>index.php</code> に対するものである場合は
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> がスキップされます。</p>
<pre class="prettyprint lang-config">RewriteBase "/"
RewriteCond "%{REQUEST_URI}" !=/index.php
RewriteRule "^(.*)" "/index.php?req=$1" [L,PT]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_n">N|next <a title="Permanent link" href="#flag_n" class="permalink">&para;</a></h2>
<p>
[N] フラグは、それまでのルールセットの結果を出発点として、ルールセットを
最初からやり直します。ループを引き起こす可能性があるため、
極めて慎重に使用してください。
</p>
<p>
[Next] フラグは、例えばリクエスト内の特定の文字列や文字を繰り返し
置換したい場合に使用できます。ここに示す例は、リクエスト内のすべての
A を B に置換し、置換すべき A がなくなるまで続けます。
</p>
<pre class="prettyprint lang-config">RewriteRule "(.*)A(.*)" "$1B$2" [N]</pre>
<p>これは <code>while</code> ループと考えることができます: このパターンが
まだマッチする間 (つまり、URI にまだ <code>A</code> が含まれている間)、
この置換を実行します (つまり、<code>A</code> を <code>B</code> に
置換します)。</p>
<p>2.5.0 以降では、意図しないループを防ぐため、10,000 回の反復後に
エラーを返します。N フラグに追加することで、代替の最大反復回数を
指定できます。</p>
<pre class="prettyprint lang-config"># ループの各パスで 1 文字を置換
RewriteRule "(.+)[&gt;&lt;;]$" "$1" [N=32000]
# ... または、10 ループ後に諦める
RewriteRule "(.+)[&gt;&lt;;]$" "$1" [N=10]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_nc">NC|nocase <a title="Permanent link" href="#flag_nc" class="permalink">&para;</a></h2>
<p>[NC] フラグを使用すると、<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> は大文字小文字を
区別せずにマッチします。つまり、マッチする URI で文字が大文字か
小文字かを気にしません。</p>
<p>以下の例では、画像ファイルのリクエストは専用の画像サーバに
プロキシされます。マッチは大文字小文字を区別しないため、例えば
<code>.jpg</code> と <code>.JPG</code> ファイルの両方が受け入れられます。</p>
<pre class="prettyprint lang-config">RewriteRule "(.*\.(jpg|gif|png))$" "http://images.example.com$1" [P,NC]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_ne">NE|noescape <a title="Permanent link" href="#flag_ne" class="permalink">&para;</a></h2>
<p>デフォルトでは、<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
が外部リダイレクトをもたらす場合、出力内の以下の安全なセット以外の文字は
16 進コード (パーセントエンコード) に変換されます:</p>
<ul>
<li>英数字: <code>A-Z</code>、<code>a-z</code>、
<code>0-9</code></li>
<li>特殊文字: <code>$-_.+!*'(),:;@&amp;=/~</code></li>
</ul>
<p>例えば、<code>#</code> は <code>%23</code> に、<code>?</code> は
<code>%3F</code> に変換されます。<code>%</code> 文字もエスケープされ
(<code>%25</code> に)、これにより置換に既に存在するパーセントエンコーディングが
二重エンコードされることを意味します。</p>
<p>[NE] フラグを使用すると、このエスケープが防止され、<code>#</code> や
<code>?</code> などの文字がそのままリダイレクト URL に渡されます。</p>
<pre class="prettyprint lang-config">RewriteRule "^/anchor/(.+)" "/bigpage.html#$1" [NE,R]</pre>
<p>
上記の例は <code>/anchor/xyz</code> を <code>/bigpage.html#xyz</code> に
リダイレクトします。[NE] を省略すると、# が 16 進コード相当の
<code>%23</code> に変換され、404 Not Found エラーが発生します。
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_ns">NS|nosubreq <a title="Permanent link" href="#flag_ns" class="permalink">&para;</a></h2>
<p>[NS] フラグを使用すると、サブリクエストでのルールの使用が
防止されます。例えば、SSI (Server Side Include) を使用して
インクルードされたページはサブリクエストであり、それらのサブリクエストで
書き換えが行われないようにしたい場合があります。また、
<code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> がディレクトリのデフォルトファイル
(<code>index.html</code> ファイルなど) の情報を調べようとする場合も
内部サブリクエストであり、そのようなサブリクエストでの書き換えを
避けたい場合が多くあります。サブリクエストでは、ルールの完全なセットが
適用されると有用でない場合やエラーを引き起こす場合があります。
問題のあるルールを除外するためにこのフラグを使用してください。</p>
<p>このルールを使用するかどうかを決定するには: CGI スクリプトで
URL をプレフィックスし、CGI スクリプトで処理させるようにしている場合、
サブリクエストで問題 (または大きなオーバーヘッド) が発生する
可能性があります。そのような場合はこのフラグを使用してください。</p>
<p>
HTML ページの一部として読み込まれる画像、JavaScript ファイル、
CSS ファイルはサブリクエストではありません - ブラウザがそれらを
別の HTTP リクエストとしてリクエストします。
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_p">P|proxy <a title="Permanent link" href="#flag_p" class="permalink">&para;</a></h2>
<p>[P] フラグを使用すると、リクエストは <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> によって
処理され、プロキシリクエストとして扱われます。例えば、すべての画像
リクエストをバックエンド画像サーバで処理したい場合、以下のようにします:</p>
<pre class="prettyprint lang-config">RewriteRule "/(.*)\.(jpg|gif|png)$" "http://images.example.com/$1.$2" [P]</pre>
<p>[P] フラグの使用は [L] を暗黙的に含みます - つまり、リクエストは
直ちにプロキシに送られ、後続のルールは考慮されません。</p>
<p>
置換文字列が <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> で処理できる有効な URI
(通常 <code>http://</code><em>hostname</em> で始まる) であることを
確認する必要があります。そうでない場合、プロキシモジュールからエラーが
発生します。このフラグは、<code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>
ディレクティブのより強力な実装を実現し、リモートコンテンツをローカル
サーバのネームスペースにマッピングするために使用します。</p>
<div class="warning">
<h3>セキュリティ警告</h3>
<p>ルールのターゲット URL を構築する際には、サーバがプロキシとして
動作する URL のセットに対するクライアントの影響のセキュリティ上の
影響を考慮してください。URL のスキームとホスト名の部分が固定されているか、
クライアントに過度の影響を与えないことを確認してください。</p>
</div>
<div class="warning">
<h3>パフォーマンス警告</h3>
<p>このフラグを使用すると、デフォルトワーカーが使用されるため、
永続的な接続が処理されない <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> の使用がトリガー
されます。接続プーリング/再利用が処理されません。</p>
<p>永続的な接続を使用するには、少なくともターゲット URL のスキームと
ホスト部分に対する <code class="directive"><a href="../mod/mod_proxy.html#proxy">Proxy</a></code>
ブロックを設定し、例えばタイムアウトを設定する
<code class="directive"><a href="../mod/mod_proxy.html#proxyset">ProxySet</a></code> ディレクティブを
含めてください。</p>
<p><code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> または
<code class="directive"><a href="../mod/mod_proxy.html#proxypassmatch">ProxyPassMatch</a></code> で設定すると、
永続的な接続が自動的に使用されます。</p>
</div>
<p>注: このフラグを使用するには <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> が
有効になっている必要があります。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_pt">PT|passthrough <a title="Permanent link" href="#flag_pt" class="permalink">&para;</a></h2>
<p>
RewriteRule のターゲット (置換文字列) はデフォルトではファイルパスと
想定されます。[PT] フラグを使用すると、代わりに URI として扱われます。
つまり、[PT] フラグを使用すると、<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> の結果が URL マッピングに
戻され、<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>、<code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>、<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> などの場所ベースのマッピングが
効果を発揮する機会が与えられます。
</p>
<p>
例えば、/icons に対する <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> があり、
そこを指す <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> がある
場合、<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> が評価されるように
[PT] フラグを使用する必要があります。
</p>
<pre class="prettyprint lang-config">Alias "/icons" "/usr/local/apache/icons"
RewriteRule "/pics/(.+)\.jpg$" "/icons/$1.gif" [PT]</pre>
<p>
この場合に [PT] フラグを省略すると、Alias が無視され、
'File not found' エラーが返されます。
</p>
<p><code>PT</code> フラグは <code>L</code> フラグを暗黙的に含みます:
リクエストを処理の次のフェーズに渡すために書き換えが停止されます。</p>
<p><code>PT</code> フラグは、
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> セクションや
<code>.htaccess</code> ファイルなどのディレクトリ単位のコンテキストでは
暗黙的に含まれることに注意してください。これを回避する唯一の方法は、
<code>-</code> に書き換えることです。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_qsa">QSA|qsappend <a title="Permanent link" href="#flag_qsa" class="permalink">&para;</a></h2>
<p>
置換 URI にクエリ文字列が含まれる場合、
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> のデフォルト動作は
既存のクエリ文字列を破棄し、新しく生成されたもので置き換えることです。
[QSA] フラグを使用すると、クエリ文字列が結合されます。
</p>
<p>以下のルールを考えてみましょう:</p>
<pre class="prettyprint lang-config">RewriteRule "/pages/(.+)" "/page.php?page=$1" [QSA]</pre>
<p>[QSA] フラグがある場合、<code>/pages/123?one=two</code> へのリクエストは
<code>/page.php?page=123&amp;one=two</code> にマッピングされます。
[QSA] フラグがない場合、同じリクエストは <code>/page.php?page=123</code>
にマッピングされます - つまり、既存のクエリ文字列は破棄されます。
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_qsd">QSD|qsdiscard <a title="Permanent link" href="#flag_qsd" class="permalink">&para;</a></h2>
<p>
リクエストされた URI にクエリ文字列が含まれ、ターゲット URI に含まれない
場合、<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> のデフォルト
動作はそのクエリ文字列をターゲット URI にコピーすることです。
[QSD] フラグを使用すると、クエリ文字列が破棄されます。
</p>
<p>このフラグはバージョン 2.4.0 以降で使用可能です。</p>
<p>
[QSD] と [QSA] を一緒に使用すると、[QSD] が優先されます。
</p>
<p>
ターゲット URI にクエリ文字列がある場合は、デフォルトの動作が
観察されます - つまり、元のクエリ文字列は破棄され、
<code>RewriteRule</code> ターゲット URI のクエリ文字列に
置き換えられます。
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_qsl">QSL|qslast <a title="Permanent link" href="#flag_qsl" class="permalink">&para;</a></h2>
<p>
デフォルトでは、置換内の最初の (左端の) 疑問符がパスとクエリ文字列を
区切ります。[QSL] フラグを使用すると、代わりに最後の (右端の) 疑問符で
2 つのコンポーネントを分割するよう
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> に指示します。</p>
<p>
これは、ファイル名にリテラルの疑問符が含まれるファイルへのマッピング時に
便利です。置換でクエリ文字列が使用されない場合、このフラグと組み合わせて
疑問符を追加できます。</p>
<p>このフラグはバージョン 2.4.19 以降で使用可能です。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_r">R|redirect <a title="Permanent link" href="#flag_r" class="permalink">&para;</a></h2>
<p>
[R] フラグを使用すると、ブラウザに HTTP リダイレクトが発行されます。
完全修飾 URL (つまり <code>http://servername/</code> を含む) が指定された
場合、その場所へのリダイレクトが発行されます。それ以外の場合は、
現在のプロトコル、サーバ名、ポート番号がリダイレクトで送信される
URL の生成に使用されます。
</p>
<p>
[R=305] のような構文を使用して、任意の有効な HTTP レスポンスステータス
コードを指定できます。指定されない場合、デフォルトの 302 ステータスコードが
使用されます。指定されたステータスコードは必ずしもリダイレクト (3xx)
ステータスコードである必要はありません。ただし、リダイレクト範囲 (300-399)
外のステータスコードの場合、置換文字列は完全に破棄され、<code>L</code>
が使用されたかのように書き換えが停止されます。</p>
<p>レスポンスステータスコードに加えて、シンボリック名を使用して
リダイレクトステータスを指定することもできます: <code>temp</code>
(デフォルト)、<code>permanent</code>、または <code>seeother</code>。</p>
<p>
[R] フラグはほぼ常に [L] と組み合わせて使用します (つまり [R,L])。
[R] フラグ単独では、URI に <code>http://thishost[:thisport]</code> を
前置しますが、これをルールセットの次のルールに渡すため、しばしば
'Invalid URI in request' 警告が発生します。
</p>
<p>注: httpd は HTTP 仕様に含まれるステータスコードのみをサポートします。
認識されないステータスコードを使用すると、500 エラーとエラーログ
メッセージが発生します。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_s">S|skip <a title="Permanent link" href="#flag_s" class="permalink">&para;</a></h2>
<p>[S] フラグは、実行したくないルールをスキップするために使用されます。
スキップフラグの構文は [S=<em>N</em>] で、<em>N</em> はスキップする
ルールの数を表します (<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
と先行する <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
ディレクティブがマッチする場合)。これは書き換えルールセット内の
<code>goto</code> 文と考えることができます。以下の例では、リクエストされた
URI が実際のファイルに対応しない場合にのみ
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> を実行したいとします。</p>
<pre class="prettyprint lang-config"># Is the request for a non-existent file?
RewriteCond "%{REQUEST_FILENAME}" !-f
RewriteCond "%{REQUEST_FILENAME}" !-d
# If so, skip these two RewriteRules
RewriteRule ".?" "-" [S=2]
RewriteRule "(.*\.gif)" "images.php?$1"
RewriteRule "(.*\.html)" "docs.php?$1"</pre>
<p>このテクニックが有用なのは、<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> は直後の
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> にのみ適用されるため
です。複数の <code>RewriteRule</code> に <code>RewriteCond</code> を
適用したい場合の一つの方法は、条件を否定して [Skip] フラグ付きの
<code>RewriteRule</code> を追加することです。これを使用して疑似的な
if-then-else 構造を作成できます: then 節の最後のルールが
<code>skip=N</code> となり、N は else 節のルール数です:</p>
<pre class="prettyprint lang-config"># Does the file exist?
RewriteCond "%{REQUEST_FILENAME}" !-f
RewriteCond "%{REQUEST_FILENAME}" !-d
# Create an if-then-else construct by skipping 3 lines if we meant to go to the "else" stanza.
RewriteRule ".?" "-" [S=3]
# IF the file exists, then:
RewriteRule "(.*\.gif)" "images.php?$1"
RewriteRule "(.*\.html)" "docs.php?$1"
# Skip past the "else" stanza.
RewriteRule ".?" "-" [S=1]
# ELSE...
RewriteRule "(.*)" "404.php?file=$1"
# END</pre>
<p>この種の設定は、代わりに <code class="directive">&lt;If&gt;</code>、
<code class="directive">&lt;ElseIf&gt;</code>、<code class="directive">&lt;Else&gt;</code> ディレクティブを使用する方が
おそらく簡単でしょう。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_t">T|type <a title="Permanent link" href="#flag_t" class="permalink">&para;</a></h2>
<p>結果のレスポンスが送信される MIME タイプを設定します。
これは <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> ディレクティブと
同じ効果を持ちます。</p>
<p>例えば、特定の方法でリクエストされた場合に Perl ソースコードを
プレーンテキストとして提供するために、以下のテクニックを使用できます:</p>
<pre class="prettyprint lang-config"># .pl ファイルをプレーンテキストとして提供
RewriteRule "\.pl$" "-" [T=text/plain]</pre>
<p>あるいは、ファイル拡張子のない jpeg 画像を生成するカメラがある場合、
ファイル名によって正しい MIME タイプで画像を提供するよう強制できます:</p>
<pre class="prettyprint lang-config"># 名前に 'IMG' を含むファイルは jpg 画像
RewriteRule "IMG" "-" [T=image/jpg]</pre>
<p>これは簡単な例であり、代わりに
<code class="directive"><a href="../mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code> を使用する
方が良いことに注意してください。問題に対する代替の解決策を常に検討して
から書き換えに頼ってください。書き換えは常に代替手段よりも
効率が悪くなります。</p>
<p>
ディレクトリ単位のコンテキストで使用する場合は、
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> 処理の<em>全ラウンド</em>の置換として
<code>-</code> (ダッシュ) のみを使用してください。そうしないと、
内部的な再処理 (<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> 処理の後続ラウンドを含む)
により、このフラグで設定された MIME タイプが失われます。
<em>現在の</em> <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> 処理ラウンドを終了するために
<code>L</code> フラグが有用です。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_unsafe_allow_3f">UnsafeAllow3F <a title="Permanent link" href="#flag_unsafe_allow_3f" class="permalink">&para;</a></h2>
<p>このフラグを設定すると、書き換え対象の HTTP リクエストに
エンコードされた疑問符 '%3f' が含まれ、書き換え結果の置換に
'?' がある場合でも書き換えを続行できます。これは、悪意のある
URL がエンコードされた疑問符のキャプチャと再置換を利用するのを
防止します。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_unsafe_prefix_stat">UnsafePrefixStat <a title="Permanent link" href="#flag_unsafe_prefix_stat" class="permalink">&para;</a></h2>
<p>このフラグを設定すると、サーバスコープの置換が変数や
バックリファレンスで始まり、ファイルシステムパスに解決される場合に
必要です。これらの置換にはドキュメントルートがプレフィックスとして
付加されません。これは、悪意のある URL が展開された置換を
予期しないファイルシステムの場所にマッピングさせるのを防止します。</p>
<p>Available in Apache HTTP Server 2.5.1 and later.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="flag_unc">UNC <a title="Permanent link" href="#flag_unc" class="permalink">&para;</a></h2>
<p>このフラグを設定すると、Windows UNC パスで使用される複数の
先頭スラッシュのマージが防止されます。ルールの置換がリテラルの
複数スラッシュで始まる場合、このフラグは不要です。</p>
<p>Available in Apache HTTP Server 2.5.1 and later.</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../de/rewrite/flags.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/rewrite/flags.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/rewrite/flags.html" hreflang="es" rel="alternate" title="Espa&ntilde;ol">&nbsp;es&nbsp;</a> |
<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="../ja/rewrite/flags.html" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/rewrite/flags.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../tr/rewrite/flags.html" hreflang="tr" rel="alternate" title="T&uuml;rk&ccedil;e">&nbsp;tr&nbsp;</a> |
<a href="../zh-cn/rewrite/flags.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>この文書は <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> のライセンスで提供されています。.</p>
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/quickreference.html">ディレクティブ</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
document.body.appendChild(qv);
var qvBtn = document.createElement('button');
qvBtn.className = 'qv-toggle';
qvBtn.setAttribute('aria-label', 'Toggle page navigation');
qvBtn.innerHTML = '&#9776;';
document.body.appendChild(qvBtn);
qvBtn.addEventListener('click', function() {
var isOpen = qv.classList.toggle('open');
if (isOpen) {
qv.style.top = window.scrollY + 10 + 'px';
}
});
window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>