下面列出了當(dāng)前可用的 PCRE 修飾符。括號(hào)中提到的名字是 PCRE 內(nèi)部這些修飾符的名稱。 模式修飾符中的空格,換行符會(huì)被忽略,其他字符會(huì)導(dǎo)致錯(cuò)誤。
- i (
PCRE_CASELESS
)- 如果設(shè)置了這個(gè)修飾符,模式中的字母會(huì)進(jìn)行大小寫不敏感匹配。
- m (
PCRE_MULTILINE
)- 默認(rèn)情況下,PCRE 認(rèn)為目標(biāo)字符串是由單行字符組成的(然而實(shí)際上它可能會(huì)包含多行), "行首"元字符 (^) 僅匹配字符串的開始位置, 而"行末"元字符 ($) 僅匹配字符串末尾, 或者最后的換行符(除非設(shè)置了 D 修飾符)。這個(gè)行為和 perl 相同。 當(dāng)這個(gè)修飾符設(shè)置之后,“行首”和“行末”就會(huì)匹配目標(biāo)字符串中任意換行符之前或之后,另外, 還分別匹配目標(biāo)字符串的最開始和最末尾位置。這等同于 perl 的 /m 修飾符。如果目標(biāo)字符串 中沒有 "\n" 字符,或者模式中沒有出現(xiàn) ^ 或 $,設(shè)置這個(gè)修飾符不產(chǎn)生任何影響。
- s (
PCRE_DOTALL
)- 如果設(shè)置了這個(gè)修飾符,模式中的點(diǎn)號(hào)元字符匹配所有字符,包含換行符。如果沒有這個(gè) 修飾符,點(diǎn)號(hào)不匹配換行符。這個(gè)修飾符等同于 perl 中的/s修飾符。 一個(gè)取反字符類比如 [^a] 總是匹配換行符,而不依賴于這個(gè)修飾符的設(shè)置。
- x (
PCRE_EXTENDED
)- 如果設(shè)置了這個(gè)修飾符,模式中的沒有經(jīng)過(guò)轉(zhuǎn)義的或不在字符類中的空白數(shù)據(jù)字符總會(huì)被忽略, 并且位于一個(gè)未轉(zhuǎn)義的字符類外部的#字符和下一個(gè)換行符之間的字符也被忽略。 這個(gè)修飾符 等同于 perl 中的 /x 修飾符,使被編譯模式中可以包含注釋。 注意:這僅用于數(shù)據(jù)字符。 空白字符 還是不能在模式的特殊字符序列中出現(xiàn),比如序列 (?( 引入了一個(gè)條件子組(譯注: 這種語(yǔ)法定義的 特殊字符序列中如果出現(xiàn)空白字符會(huì)導(dǎo)致編譯錯(cuò)誤。 比如(?(就會(huì)導(dǎo)致錯(cuò)誤)。
- A (
PCRE_ANCHORED
)- 如果設(shè)置了這個(gè)修飾符,模式被強(qiáng)制為"錨定"模式,也就是說(shuō)約束匹配使其僅從 目標(biāo)字符串的開始位置搜索。這個(gè)效果同樣可以使用適當(dāng)?shù)哪J綐?gòu)造出來(lái),并且 這也是 perl 種實(shí)現(xiàn)這種模式的唯一途徑。
- D (
PCRE_DOLLAR_ENDONLY
)- 如果這個(gè)修飾符被設(shè)置,模式中的元字符美元符號(hào)僅僅匹配目標(biāo)字符串的末尾。如果這個(gè)修飾符 沒有設(shè)置,當(dāng)字符串以一個(gè)換行符結(jié)尾時(shí), 美元符號(hào)還會(huì)匹配該換行符(但不會(huì)匹配之前的任何換行符)。 如果設(shè)置了修飾符m,這個(gè)修飾符被忽略. 在 perl 中沒有與此修飾符等同的修飾符。
- S
- 當(dāng)一個(gè)模式需要多次使用的時(shí)候,為了得到匹配速度的提升,值得花費(fèi)一些時(shí)間 對(duì)其進(jìn)行一些額外的分析。如果設(shè)置了這個(gè)修飾符,這個(gè)額外的分析就會(huì)執(zhí)行。當(dāng)前, 這種對(duì)一個(gè)模式的分析僅僅適用于非錨定模式的匹配(即沒有單獨(dú)的固定開始字符)。
- U (
PCRE_UNGREEDY
)- 這個(gè)修飾符逆轉(zhuǎn)了量詞的"貪婪"模式。 使量詞默認(rèn)為非貪婪的,通過(guò)量詞后緊跟
?
的方式可以使其成為貪婪的。這和 perl 是不兼容的。 它同樣可以使用 模式內(nèi)修飾符設(shè)置 (?U
)進(jìn)行設(shè)置, 或者在量詞后以問號(hào)標(biāo)記其非貪婪(比如.*?
)。注意:
在非貪婪模式,通常不能匹配超過(guò) pcre.backtrack_limit 的字符。
- X (
PCRE_EXTRA
)- 這個(gè)修飾符打開了 PCRE 與 perl 不兼容的附件功能。模式中的任意反斜線后就 ingen 一個(gè) 沒有特殊含義的字符都會(huì)導(dǎo)致一個(gè)錯(cuò)誤,以此保留這些字符以保證向后兼容性。 默認(rèn)情況下,在 perl 中,反斜線緊跟一個(gè)沒有特殊含義的字符被認(rèn)為是該字符的原文。 當(dāng)前沒有其他特性由這個(gè)修飾符控制。
- J (
PCRE_INFO_JCHANGED
)- 內(nèi)部選項(xiàng)設(shè)置(?J)修改本地的
PCRE_DUPNAMES
選項(xiàng)。允許子組重名, (譯注:只能通過(guò)內(nèi)部選項(xiàng)設(shè)置,外部的 /J 設(shè)置會(huì)產(chǎn)生錯(cuò)誤。) 自 PHP 7.2.0 起,也能支持J
修飾符。- u (
PCRE_UTF8
)- 此修正符打開一個(gè)與 Perl 不兼容的附加功能。 模式和目標(biāo)字符串都被認(rèn)為是 UTF-8 的。 無(wú)效的目標(biāo)字符串會(huì)導(dǎo)致 preg_* 函數(shù)什么都匹配不到; 無(wú)效的模式字符串會(huì)導(dǎo)致 E_WARNING 級(jí)別的錯(cuò)誤。 5 字節(jié)和 6 字節(jié)的 UTF-8 字符序列以無(wú)效字符序列對(duì)待。