(PHP 4, PHP 5, PHP 7, PHP 8)
preg_replace — 執(zhí)行一個(gè)正則表達(dá)式的搜索和替換
$pattern,$replacement,$subject,$limit = -1,&$count = null
搜索 subject 中匹配 pattern 的部分，以
replacement 進(jìn)行替換。
pattern要搜索的模式?？梢允挂粋€(gè)字符串或字符串?dāng)?shù)組。
可以使用一些 PCRE 修飾符。
replacement
用于替換的字符串或字符串?dāng)?shù)組。如果這個(gè)參數(shù)是一個(gè)字符串，并且 pattern
是一個(gè)數(shù)組，那么所有的模式都使用這個(gè)字符串進(jìn)行替換。如果 pattern 和 replacement
都是數(shù)組，每個(gè) pattern 使用 replacement 中對(duì)應(yīng)的元素進(jìn)行替換。如果
replacement 中的元素比 pattern 中的少，多出來(lái)的
pattern 使用空字符串進(jìn)行替換。
replacement 中可以包含后向引用 \\n
或 $n，語(yǔ)法上首選后者。 每個(gè)這樣的引用將被匹配到的第
n 個(gè)捕獲子組捕獲到的文本替換。 n 可以是0-99，\\0 和 $0
代表完整的模式匹配文本。捕獲子組的序號(hào)計(jì)數(shù)方式為：代表捕獲子組的左括號(hào)從左到右， 從1開(kāi)始數(shù)。如果要在
replacement 中使用反斜線(xiàn)，必須使用 4 個(gè)("\\\\"，譯注：因?yàn)檫@首先是 PHP
的字符串，經(jīng)過(guò)轉(zhuǎn)義后，是兩個(gè)，再經(jīng)過(guò)正則表達(dá)式引擎后才被認(rèn)為是一個(gè)原文反斜線(xiàn))。
當(dāng)在替換模式下工作并且后向引用后面緊跟著需要是另外一個(gè)數(shù)字 (比如：在一個(gè)匹配模式后緊接著增加一個(gè)原文數(shù)字)，不能使用
\\1 這樣的語(yǔ)法來(lái)描述后向引用。比如，\\11將會(huì)使preg_replace()
不能理解你希望的是一個(gè) \\1 后向引用緊跟一個(gè)原文 1，還是一個(gè)
\\11 后向引用后面不跟任何東西。 這種情況下解決方案是使用 ${1}1。這創(chuàng)建了一個(gè)獨(dú)立的
$1 后向引用, 一個(gè)獨(dú)立的原文 1。
當(dāng)使用被棄用的 e 修飾符時(shí), 這個(gè)函數(shù)會(huì)轉(zhuǎn)義一些字符 (即：'、"、
\ 和 NULL) 然后進(jìn)行后向引用替換。當(dāng)這些完成后請(qǐng)確保后向引用解析完后沒(méi)有單引號(hào)或雙引號(hào)引起的語(yǔ)法錯(cuò)誤 (比如：
'strlen(\'$1\')+strlen("$2")')。確保符合 PHP 的
字符串語(yǔ)法，并且符合 eval 語(yǔ)法。因?yàn)樵谕瓿商鎿Q后，引擎會(huì)將結(jié)果字符串作為 PHP 代碼使用
eval 方式進(jìn)行評(píng)估并將返回值作為最終參與替換的字符串。
subject要進(jìn)行搜索和替換的字符串或字符串?dāng)?shù)組。
如果 subject 是一個(gè)數(shù)組，搜索和替換回在
subject 的每一個(gè)元素上進(jìn)行, 并且返回值也會(huì)是一個(gè)數(shù)組。
limit
每個(gè)模式在每個(gè) subject 上進(jìn)行替換的最大次數(shù)。默認(rèn)是
-1(無(wú)限)。
count如果指定，將會(huì)被填充為完成的替換次數(shù)。
如果 subject 是一個(gè)數(shù)組，preg_replace()
返回一個(gè)數(shù)組，其他情況下返回一個(gè)字符串。
如果匹配被查找到，替換后的 subject 被返回，其他情況下返回沒(méi)有改變的
subject。如果發(fā)生錯(cuò)誤，返回 null 。
"\e" 會(huì)并忽略，并產(chǎn)生
E_WARNING 錯(cuò)誤。
示例 #1 使用后向引用緊跟數(shù)值原文
<?php
$string = 'April 15, 2003';
$pattern = '/(\w+) (\d+), (\d+)/i';
$replacement = '${1}1,$3';
echo preg_replace($pattern, $replacement, $string);
?>
以上例程會(huì)輸出：
April1,2003
示例 #2 preg_replace() 中使用基于索引的數(shù)組
<?php
$string = 'The quick brown fox jumps over the lazy dog.';
$patterns = array();
$patterns[0] = '/quick/';
$patterns[1] = '/brown/';
$patterns[2] = '/fox/';
$replacements = array();
$replacements[2] = 'bear';
$replacements[1] = 'black';
$replacements[0] = 'slow';
echo preg_replace($patterns, $replacements, $string);
?>
以上例程會(huì)輸出：
The bear black slow jumps over the lazy dog.
對(duì)模式和替換內(nèi)容按 key 進(jìn)行排序我們可以得到期望的結(jié)果。
<?php
ksort($patterns);
ksort($replacements);
echo preg_replace($patterns, $replacements, $string);
?>
以上例程會(huì)輸出：
The slow black bear jumps over the lazy dog.
示例 #3 替換一些值
<?php
$patterns = array ('/(19|20)(\d{2})-(\d{1,2})-(\d{1,2})/',
'/^\s*{(\w+)}\s*=/');
$replace = array ('\3/\4/\1\2', '$\1 =');
echo preg_replace($patterns, $replace, '{startDate} = 1999-5-27');
?>
以上例程會(huì)輸出：
$startDate = 5/27/1999
示例 #4 剝離空白字符
這個(gè)例子剝離多余的空白字符
<?php
$str = 'foo o';
$str = preg_replace('/\s\s+/', ' ', $str);
// 將會(huì)改變?yōu)?foo o'
echo $str;
?>
示例 #5 使用參數(shù) count
<?php
$count = 0;
echo preg_replace(array('/\d/', '/\s/'), '*', 'xp 4 to', -1 , $count);
echo $count; //3
?>
以上例程會(huì)輸出：
xp***to 3
注意:
當(dāng)使用數(shù)組形式的
pattern和replacement時(shí), 將會(huì)按照key在數(shù)組中出現(xiàn)的順序進(jìn)行處理. 這不一定和數(shù)組的索引順序一致. 如果你期望使用索引對(duì)等方式用replacement對(duì)pattern進(jìn)行替換, 你可以在調(diào)用preg_replace()之前對(duì)兩個(gè)數(shù)組各進(jìn)行一次ksort()排序.