PageRenderTime 49ms CodeModel.GetById 18ms RepoModel.GetById 0ms app.codeStats 0ms

/php-chunked-xhtml/reference.pcre.pattern.modifiers.html

https://github.com/tsujita/dotfiles
HTML | 309 lines | 254 code | 55 blank | 0 comment | 0 complexity | 737e8865844a26c4cd11c3a35f4706cc MD5 | raw file
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3.  <head>
    4. 

  4.   <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    5. 

  5.   <title>パターン修飾子</title>
    6. 

  6. 

  7.  </head>
    8. 

  8.  <body><div class="manualnavbar" style="text-align: center;">
    9. 

  9.  <div class="prev" style="text-align: left; float: left;"><a href="pcre.pattern.html">PCRE のパターン</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="reference.pcre.pattern.differences.html">Perl とは異なる点</a></div>
    11. 

  11.  <div class="up"><a href="pcre.pattern.html">PCRE のパターン</a></div>
    12. 

  12.  <div class="home"><a href="index.html">PHP Manual</a></div>
    13. 

  13. </div><hr /><div id="reference.pcre.pattern.modifiers" class="article">
    14. 

  14.  <h1>パターン修飾子</h1>
    15. 

  15. 

  16.  
    17. 

  17.     <p class="para">
    18. 

  18.      現在使用可能な PCRE 修飾子の一覧を以下に示します。
    19. 

  19.      括弧の中の名前は、これらの修飾子に関する PCRE 内部の名前です。
    20. 

  20.      修飾子中での空白文字および改行は無視されます。他の文字はエラーになります。
    21. 

  21.     </p>
    22. 

  22.     <p class="para">
    23. 

  23.      <blockquote class="blockquote">
    24. 

  24.       <dl>
    25. 

  25. 

  26.        <dt>
    27. 

  27. 

  28.         <span class="term"><em class="emphasis">i</em> (<em>PCRE_CASELESS</em>)</span>
    29. 

  29.         <dd>
    30. 

  30. 

  31.          <span class="simpara">
    32. 

  32.          この修飾子を設定すると、パターンの中の文字は
    33. 

  33.          大文字にも小文字にもマッチします。
    34. 

  34.          </span>
    35. 

  35.         </dd>
    36. 

  36. 

  37.        </dt>
    38. 

  38. 

  39.        <dt>
    40. 

  40. 

  41.         <span class="term"><em class="emphasis">m</em> (<em>PCRE_MULTILINE</em>)</span>
    42. 

  42.         <dd>
    43. 

  43. 

  44.          <span class="simpara">
    45. 

  45.           デフォルトで、PCRE は、検索対象文字列を（実際には複数行からなる
    46. 

  46.           場合でも）単一の行からなるとして処理します。
    47. 

  47.           「行頭」メタ文字 (^) は、対象文字列の最初にしかマッチしません。
    48. 

  48.           一方、「行末」メタ文字 ($) は、文字列の最後、または
    49. 

  49.           （<em class="emphasis">D</em> 修飾子が設定されていない場合）
    50. 

  50.           最後にある改行記号の前のみにしかマッチしません。
    51. 

  51.           この動作は Perl と同じです。
    52. 

  52.          </span>
    53. 

  53.          <span class="simpara">
    54. 

  54.           この修飾子を設定すると、「行頭」および「行末」メタ文字は
    55. 

  55.           対象文字列において、文字列の最初と最後に加えて、
    56. 

  56.           各改行の直前と直後にそれぞれマッチします。
    57. 

  57.           この動作は、Perl の /m 修飾子と同じです。
    58. 

  58.           対象文字列の中に &quot;\n&quot; 文字がない場合や、
    59. 

  59.           またはパターンに ^ または $ がない場合は、
    60. 

  60.           この修飾子を設定しても意味はありません。
    61. 

  61.          </span>
    62. 

  62.         </dd>
    63. 

  63. 

  64.        </dt>
    65. 

  65. 

  66.        <dt>
    67. 

  67. 

  68.         <span class="term"><em class="emphasis">s</em> (<em>PCRE_DOTALL</em>)</span>
    69. 

  69.         <dd>
    70. 

  70. 

  71.          <span class="simpara">
    72. 

  72.           この修飾子を設定すると、パターン中のドットメタ文字は
    73. 

  73.           改行を含む全ての文字にマッチします。
    74. 

  74.           これを設定しない場合は、改行にはマッチしません。
    75. 

  75.           この修飾子は、Perl の /s 修飾子と同じです。
    76. 

  76.           [^a] のような否定の文字クラスは、
    77. 

  77.           この修飾子の設定によらず、常に改行文字にマッチします。
    78. 

  78.          </span>
    79. 

  79.         </dd>
    80. 

  80. 

  81.        </dt>
    82. 

  82. 

  83.        <dt>
    84. 

  84. 

  85.         <span class="term"><em class="emphasis">x</em> (<em>PCRE_EXTENDED</em>)</span>
    86. 

  86.         <dd>
    87. 

  87. 

  88.          <span class="simpara">
    89. 

  89.           この修飾子を設定すると、エスケープするか
    90. 

  90.           文字クラスの内部を除き、
    91. 

  91.           パターンの空白文字は完全に無視されます。
    92. 

  92.           文字クラスの外にあって、かつエスケープされていない # 
    93. 

  93.           と次の改行文字の間の文字も無視されます。
    94. 

  94.           この動作は、Perl の /x 修飾子と同じであり、複雑なパターンの内部に
    95. 

  95.           コメントを記述することが可能となります。
    96. 

  96.           しかし、この修飾子は、データ文字にのみ適用されることに注意
    97. 

  97.           してください。空白文字をパターンの特殊文字の並びの中、
    98. 

  98.           例えば条件付きサブパターン (?( の内部に置くことはできません。 
    99. 

  99.          </span>
    100. 

  100.         </dd>
    101. 

  101. 

  102.        </dt>
    103. 

  103. 

  104.        <dt>
    105. 

  105. 

  106.         <span class="term"><em class="emphasis">e</em> (<em>PREG_REPLACE_EVAL</em>)</span>
    107. 

  107.         <dd>
    108. 

  108. 

  109.        <div class="warning"><strong class="warning">警告</strong><p class="simpara">この機能は PHP 5.5.0 で
    110. 

  110. <em class="emphasis">非推奨</em>になります。この機能に頼らないことを強く推奨します。</p></div>
    111. 

  111.          <span class="simpara">
    112. 

  112.           この修飾子を設定すると、 <span class="function"><a href="function.preg-replace.html" class="function">preg_replace()</a></span>
    113. 

  113.           は、置換文字列において後方参照に関する通常の置換を行った後、
    114. 

  114.           PHP コードとして評価し、検索文字列を置換するためにその結果を
    115. 

  115.           使用します。
    116. 

  116.           置換された後方参照においては、
    117. 

  117.           単引用符や二重引用符、バックスラッシュ (<em>\</em>)および NULL 文字は
    118. 

  118.           バックスラッシュでエスケープされます。
    119. 

  119.          </span>
    120. 

  120.        <div class="caution"><strong class="caution">警告</strong>
    121. 

  121.         <p class="para">
    122. 

  122.          マッチした後方参照ごとに  <span class="function"><a href="function.addslashes.html" class="function">addslashes()</a></span> が実行されてから、
    123. 

  123.          置換を行います。つまり、クォートした文字列として後方参照を利用した場合、
    124. 

  124.          エスケープした文字がリテラルに変換されます。
    125. 

  125.          しかし、エスケープされた文字については、通常は変換されず、
    126. 

  126.          スラッシュが残ったままになります。
    127. 

  127.          そのため、この修飾子はとても複雑なものになってしまいます。
    128. 

  128.         </p>
    129. 

  129.        </div>
    130. 

  130.        <div class="caution"><strong class="caution">警告</strong>
    131. 

  131.         <p class="para">
    132. 

  132.          <em><code class="parameter">replacement</code></em> が PHP のコードとして妥当な文字列であることを確認しましょう。
    133. 

  133.          そうでない場合は、
    134. 

  134.           <span class="function"><a href="function.preg-replace.html" class="function">preg_replace()</a></span> を含む行で PHP のパースエラーが発生します。
    135. 

  135.         </p>
    136. 

  136.        </div>
    137. 

  137.        <div class="caution"><strong class="caution">警告</strong>
    138. 

  138.         <p class="para">
    139. 

  139.          この修飾子を使うことは<em class="emphasis">おすすめしません</em>。
    140. 

  140.          セキュリティに関する脆弱性を作ってしまいがちだからです。
    141. 

  141.         </p>
    142. 

  142.         <div class="informalexample">
    143. 

  143.          <div class="example-contents">
    144. 

  144. <div class="phpcode"><code><span style="color: #000000">
    145. 

  145. <span style="color: #0000BB">&lt;?php<br />$html&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">$_POST</span><span style="color: #007700">[</span><span style="color: #DD0000">'html'</span><span style="color: #007700">];<br /><br /></span><span style="color: #FF8000">//&nbsp;見出しを大文字にします<br /></span><span style="color: #0000BB">$html&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">preg_replace</span><span style="color: #007700">(<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #DD0000">'(&lt;h([1-6])&gt;(.*?)&lt;/h\1&gt;)e'</span><span style="color: #007700">,<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #DD0000">'"&lt;h$1&gt;"&nbsp;.&nbsp;strtoupper("$2")&nbsp;.&nbsp;"&lt;/h$1&gt;"'</span><span style="color: #007700">,<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$html<br /></span><span style="color: #007700">);</span>
    146. 

  146. </span>
    147. 

  147. </code></div>
    148. 

  148.          </div>
    149. 

  149. 

  150.         </div>
    151. 

  151.         <p class="para">
    152. 

  152.          このサンプルを攻撃するのは簡単で、
    153. 

  153.          <em>&lt;h1&gt;{${eval($_GET[php_code])}}&lt;/h1&gt;</em>
    154. 

  154.          のような文字列を渡すだけで攻略できます。
    155. 

  155.          攻撃者は任意の PHP コードを実行でき、
    156. 

  156.          サーバーに対するほぼ完全なアクセス権を与えることになってしまいます。
    157. 

  157.         </p>
    158. 

  158.         <p class="para">
    159. 

  159.          この種のリモートコード実行脆弱性を回避するには、
    160. 

  160.           <span class="function"><a href="function.preg-replace-callback.html" class="function">preg_replace_callback()</a></span> 関数を使うようにしなければなりません。
    161. 

  161.         </p>
    162. 

  162.         <div class="informalexample">
    163. 

  163.          <div class="example-contents">
    164. 

  164. <div class="phpcode"><code><span style="color: #000000">
    165. 

  165. <span style="color: #0000BB">&lt;?php<br />$html&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">$_POST</span><span style="color: #007700">[</span><span style="color: #DD0000">'html'</span><span style="color: #007700">];<br /><br /></span><span style="color: #FF8000">//&nbsp;見出しを大文字にします<br /></span><span style="color: #0000BB">$html&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">preg_replace_callback</span><span style="color: #007700">(<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #DD0000">'(&lt;h([1-6])&gt;(.*?)&lt;/h\1&gt;)'</span><span style="color: #007700">,<br />&nbsp;&nbsp;&nbsp;&nbsp;function&nbsp;(</span><span style="color: #0000BB">$m</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;</span><span style="color: #DD0000">"&lt;h</span><span style="color: #0000BB">$m</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]</span><span style="color: #DD0000">&gt;"&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">strtoupper</span><span style="color: #007700">(</span><span style="color: #0000BB">$m</span><span style="color: #007700">[</span><span style="color: #0000BB">2</span><span style="color: #007700">])&nbsp;.&nbsp;</span><span style="color: #DD0000">"&lt;/h</span><span style="color: #0000BB">$m</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]</span><span style="color: #DD0000">&gt;"</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;},<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$html<br /></span><span style="color: #007700">);</span>
    166. 

  166. </span>
    167. 

  167. </code></div>
    168. 

  168.          </div>
    169. 

  169. 

  170.         </div>
    171. 

  171.        </div>
    172. 

  172.        <blockquote class="note"><p><strong class="note">注意</strong>: 
    173. 

  173.         <p class="para">
    174. 

  174.          この修飾子を使用するのは、 <span class="function"><a href="function.preg-replace.html" class="function">preg_replace()</a></span>のみです。
    175. 

  175.          他の PCRE 関数では無視されます。
    176. 

  176.         </p>
    177. 

  177.        </p></blockquote>
    178. 

  178.         </dd>
    179. 

  179. 

  180.        </dt>
    181. 

  181. 

  182.        <dt>
    183. 

  183. 

  184.         <span class="term"><em class="emphasis">A</em> (<em>PCRE_ANCHORED</em>)</span>
    185. 

  185.         <dd>
    186. 

  186. 

  187.          <span class="simpara">
    188. 

  188.           この修飾子を設定すると、パターンは強制的に固定 (anchored) となります。
    189. 

  189.           つまり、検索対象文字列の先頭でのみマッチするように制限されます。
    190. 

  190.           パターン自体の中に適当な指定を行うことでも同様の効果を得ることが可能です。
    191. 

  191.           Perl ではパターン中に指定する方法しか使用できません。
    192. 

  192.          </span>
    193. 

  193.         </dd>
    194. 

  194. 

  195.        </dt>
    196. 

  196. 

  197.        <dt>
    198. 

  198. 

  199.         <span class="term"><em class="emphasis">D</em> (<em>PCRE_DOLLAR_ENDONLY</em>)</span>
    200. 

  200.         <dd>
    201. 

  201. 

  202.          <span class="simpara">
    203. 

  203.           この修飾子を設定すると、パターン内のドルメタ文字は、検索対象文字列の
    204. 

  204.           終わりにのみマッチします。この修飾子を設定しない場合、ドル記号は、
    205. 

  205.           検索対象文字列の最後の文字が改行文字であれば、その直前にもマッチします。
    206. 

  206.           この修飾子は、<em class="emphasis">m</em> を設定している場合に無視されます。
    207. 

  207.           Perl には、この修飾子に等価なものはありません。
    208. 

  208.          </span>
    209. 

  209.         </dd>
    210. 

  210. 

  211.        </dt>
    212. 

  212. 

  213.        <dt>
    214. 

  214. 

  215.         <span class="term"><em class="emphasis">S</em></span>
    216. 

  216.         <dd>
    217. 

  217. 

  218.          <span class="simpara">
    219. 

  219.           あるパターンを複数回使用する場合は、マッチングにかかる時間を
    220. 

  220.           高速化することを目的として、パターンの分析に幾分か時間をかけても
    221. 

  221.           良いでしょう。この修飾子を設定すると、追加のパターン分析が
    222. 

  222.           行われます。現在、パターン分析は、最初の文字が単一ではなく、
    223. 

  223.           かつ固定でないパターンに対してのみ有用です。
    224. 

  224.          </span>
    225. 

  225.         </dd>
    226. 

  226. 

  227.        </dt>
    228. 

  228. 

  229.        <dt>
    230. 

  230. 

  231.         <span class="term"><em class="emphasis">U</em> (<em>PCRE_UNGREEDY</em>)</span>
    232. 

  232.         <dd>
    233. 

  233. 

  234.          <span class="simpara">
    235. 

  235.           この修飾子を設定すると、量指定子の「貪欲さ」が反転します。
    236. 

  236.           つまり、量指定子は、デフォルトで貪欲でなく、
    237. 

  237.           疑問符を後ろに付けてはじめて貪欲になるようになります。
    238. 

  238.           この修飾子は Perl 互換では有りません。
    239. 

  239.           同様の設定は、(<em>?U</em>) 修飾子を <a href="regexp.reference.internal-options.html" class="link">パターン内で設定</a>
    240. 

  240.           するか、（<em>.*?</em> のように）量指定子の後に疑問符を
    241. 

  241.           付けるかすることで行うこともできます。
    242. 

  242.          </span>
    243. 

  243.        <blockquote class="note"><p><strong class="note">注意</strong>: 
    244. 

  244.         <p class="para">
    245. 

  245.          通常は、非貪欲モードでは <a href="pcre.configuration.html#ini.pcre.backtrack-limit" class="link">pcre.backtrack_limit</a>
    246. 

  246.          文字を超えるマッチができません。
    247. 

  247.         </p>
    248. 

  248.        </p></blockquote>
    249. 

  249.         </dd>
    250. 

  250. 

  251.        </dt>
    252. 

  252. 

  253.        <dt>
    254. 

  254. 

  255.         <span class="term"><em class="emphasis">X</em> (<em>PCRE_EXTRA</em>)</span>
    256. 

  256.         <dd>
    257. 

  257. 

  258.          <span class="simpara">
    259. 

  259.           この修正子は、Perl 非互換な PCRE の機能を有効にします。
    260. 

  260.           パターン内で後ろに文字が続くバックスラッシュで特別な意味がないものは、
    261. 

  261.           将来的な拡張の際の互換性の維持のため、エラーになります。
    262. 

  262.           デフォルトでは、Perl のように文字が後ろに続くバックスラッシュ
    263. 

  263.           で特に意味がないものは、リテラルとして処理されます。
    264. 

  264.           この修飾子により制御される機能は、現在の所、これだけです。
    265. 

  265.        </span>
    266. 

  266.       </dd>
    267. 

  267. 

  268.      </dt>
    269. 

  269. 

  270.      <dt>
    271. 

  271. 

  272.       <span class="term"><em class="emphasis">J</em> (<em>PCRE_INFO_JCHANGED</em>)</span>
    273. 

  273.       <dd>
    274. 

  274. 

  275.        <span class="simpara">
    276. 

  276.         (?J) 内部オプションは、ローカルのオプション <em>PCRE_DUPNAMES</em> の設定を変更します。
    277. 

  277.         サブパターンで重複した名前を使用できるようになります。
    278. 

  278.          </span>
    279. 

  279.         </dd>
    280. 

  280. 

  281.        </dt>
    282. 

  282. 

  283.        <dt>
    284. 

  284. 

  285.         <span class="term"><em class="emphasis">u</em> (<em>PCRE_UTF8</em>)</span>
    286. 

  286.         <dd>
    287. 

  287. 

  288.          <span class="simpara">
    289. 

  289.           この修正子は、Perl 非互換な PCRE の機能を有効にします。パターン
    290. 

  290.           文字列は、UTF-8 エンコードされた文字列として処理されます。
    291. 

  291.           この修正子は、UNIX では PHP 4.1.0 以降、Win32 では PHP 4.2.3 以降で
    292. 

  292.           使用可能です。
    293. 

  293.           また、PHP 4.3.5 以降では、パターンの UTF-8 としての妥当性も確認されます。
    294. 

  294.          </span>
    295. 

  295.         </dd>
    296. 

  296. 

  297.        </dt>
    298. 

  298. 

  299.       </dl>
    300. 

  300. 

  301.      </blockquote>
    302. 

  302.     </p>
    303. 

  303. </div>
    304. 

  304. <hr /><div class="manualnavbar" style="text-align: center;">
    305. 

  305.  <div class="prev" style="text-align: left; float: left;"><a href="pcre.pattern.html">PCRE のパターン</a></div>
    306. 

  306.  <div class="next" style="text-align: right; float: right;"><a href="reference.pcre.pattern.differences.html">Perl とは異なる点</a></div>
    307. 

  307.  <div class="up"><a href="pcre.pattern.html">PCRE のパターン</a></div>
    308. 

  308.  <div class="home"><a href="index.html">PHP Manual</a></div>
    309. 

  309. </div></body></html>
    310. 

  310.