mixed preg_replace ( mixed pattern, mixed replacement, mixed subject [, int limit])


在 subject 中搜索 pattern 模式的匹配项并替换为 replacement。如果指定了 limit，则仅替换 limit 个匹配，如果省略 limit 或者其值为 -1，则所有的匹配项都会被替换。 
replacement 可以包含 \n 形式或（自 PHP 4.0.4 起）$n 形式的逆向引用，首选使用后者。每个此种引用将被替换为与第 n 个被捕获的括号内的子模式所匹配的文本。n 可以从 0 到 99，其中 \0 或 $0 指的是被整个模式所匹配的文本。对左圆括号从左到右计数（从 1 开始）以取得子模式的数目。 
对替换模式在一个逆向引用后面紧接着一个数字时（即：紧接在一个匹配的模式后面的数字），不能使用熟悉的 \1 符号来表示逆向引用。举例说 \11，将会使 preg_replace() 搞不清楚是想要一个 \1 的逆向引用后面跟着一个数字 1 还是一个 \11 的逆向引用。本例中的解决方法是使用 ${1}1。这会形成一个隔离的 $1 逆向引用，而使另一个 1 只是单纯的文字。 
例子 1. 逆向引用后面紧接着数字的用法 

<?php  $string = "April 15, 2003";  $pattern = "/(w+) (d+), (d+)/i";  $replacement = "${1}1,$3";  print preg_replace($pattern, $replacement, $string);  /* Output     ======  April1,2003  */  ?>

 
如果搜索到匹配项，则会返回被替换后的 subject，否则返回原来不变的 subject。 
preg_replace() 的每个参数（除了 limit）都可以是一个数组。如果 pattern 和 replacement 都是数组，将以其键名在数组中出现的顺序来进行处理。这不一定和索引的数字顺序相同。如果使用索引来标识哪个 pattern 将被哪个 replacement 来替换，应该在调用 preg_replace() 之前用 ksort() 对数组进行排序。 
例子 2. 在 preg_replace() 中使用索引数组 

<?php  $string = "The quick brown fox jumped over the lazy dog.";  $patterns[0] = "/quick/";  $patterns[1] = "/brown/";  $patterns[2] = "/fox/";  $replacements[2] = "bear";  $replacements[1] = "black";  $replacements[0] = "slow";  print preg_replace($patterns, $replacements, $string);  /* Output     ======  The bear black slow jumped over the lazy dog.  */  /* By ksorting patterns and replacements,     we should get what we wanted. */  ksort($patterns);  ksort($replacements);  print preg_replace($patterns, $replacements, $string);  /* Output     ======  The slow black bear jumped over the lazy dog.  */  ?>

 
如果 subject 是个数组，则会对 subject 中的每个项目执行搜索和替换，并返回一个数组。 
如果 pattern 和 replacement 都是数组，则 preg_replace() 会依次从中分别取出值来对 subject 进行搜索和替换。如果 replacement 中的值比 pattern 中的少，则用空字符串作为余下的替换值。如果 pattern 是数组而 replacement 是字符串，则对 pattern 中的每个值都用此字符串作为替换值。反过来则没有意义了。 
/e 修正符使 preg_replace() 将 replacement 参数当作 PHP 代码（在适当的逆向引用替换完之后）。提示：要确保 replacement 构成一个合法的 PHP 代码字符串，否则 PHP 会在报告在包含 preg_replace() 的行中出现语法解析错误。 
例子 3. 替换数个值 

<?php  $patterns = array ("/(19|20)(d{2})-(d{1,2})-(d{1,2})/",                     "/^s*{(w+)}s*=/");  $replace = array ("\3/\4/\1\2", "$\1 =");  print preg_replace ($patterns, $replace, "{startDate} = 1999-5-27");  ?>

 

本例将输出：$startDate = 5/27/1999



例子 4. 使用 /e 修正符 

<?php  preg_replace ("/(</?)(w+)([^>]*>)/e",                "'\1'.strtoupper('\2').'\3'",                $html_body);  ?>

这将使输入字符串中的所有 HTML 标记变成大写。 

例子 5. 将 HTML 转换成文本 

<?php  // $document 应包含一个 HTML 文档。  // 本例将去掉 HTML 标记，javascript 代码  // 和空白字符。还会将一些通用的  // HTML 实体转换成相应的文本。  $search = array ("'<script[^>]*?>.*?</script>'si",  // 去掉 javascript                   "'<[/!]*?[^<>]*?>'si",           // 去掉 HTML 标记                   "'([rn])[s]+'",                 // 去掉空白字符                   "'&(quot|#34);'i",                 // 替换 HTML 实体                   "'&(amp|#38);'i",                   "'&(lt|#60);'i",                   "'&(gt|#62);'i",                   "'&(nbsp|#160);'i",                   "'&(iexcl|#161);'i",                   "'&(cent|#162);'i",                   "'&(pound|#163);'i",                   "'&(copy|#169);'i",                   "'&#(d+);'e");                    // 作为 PHP 代码运行  $replace = array ("",                    "",                    "\1",                    """,                    "&",                    "<",                    ">",                    " ",                    chr(161),                    chr(162),                    chr(163),                    chr(169),                    "chr(\1)");  $text = preg_replace ($search, $replace, $document);  ?>

 
注: limit 参数是 PHP 4.0.1pl2 之后加入的。