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