正則表達式模式修飾符


下面列出了當前可用的 PCRE 修飾符。括號中提到的名字是 PCRE 內部這些修飾符的名稱。 模式修飾符中的空格,換行符會被忽略,其他字符會導致錯誤。

 

i ( PCRE_CASELESS)
如果設置了這個修飾符,模式中的字母會進行大小寫不敏感匹配。
m ( PCRE_MULTILINE)
默認情況下,PCRE 認為目標字符串是由單行字符組成的(然而實際上它可能會包含多行), "行首"元字符 (^) 僅匹配字符串的開始位置, 而"行末"元字符 ($) 僅匹配字符串末尾, 或者最后的換行符(除非設置了 D 修飾符)。這個行為和 perl 相同。 當這個修飾符設置之后,“行首”和“行末”就會匹配目標字符串中任意換行符之前或之后,另外, 還分別匹配目標字符串的最開始和最末尾位置。這等同於 perl 的 /m 修飾符。如果目標字符串 中沒有 "\n" 字符,或者模式中沒有出現 ^ 或 $,設置這個修飾符不產生任何影響。
s ( PCRE_DOTALL)
如果設置了這個修飾符,模式中的點號元字符匹配所有字符,包含換行符。如果沒有這個 修飾符,點號不匹配換行符。這個修飾符等同於 perl 中的/s修飾符。 一個取反字符類比如 [^a] 總是匹配換行符,而不依賴於這個修飾符的設置。
x ( PCRE_EXTENDED)
如果設置了這個修飾符,模式中的沒有經過轉義的或不在字符類中的空白數據字符總會被忽略, 並且位於一個未轉義的字符類外部的#字符和下一個換行符之間的字符也被忽略。 這個修飾符 等同於 perl 中的 /x 修飾符,使被編譯模式中可以包含注釋。 注意:這僅用於數據字符。 空白字符 還是不能在模式的特殊字符序列中出現,比如序列 (?( 引入了一個條件子組(譯注: 這種語法定義的 特殊字符序列中如果出現空白字符會導致編譯錯誤。 比如(?(就會導致錯誤)。
e ( PREG_REPLACE_EVAL)
Warning

This feature was DEPRECATED in PHP 5.5.0, and REMOVED as of PHP 7.0.0.

如果設置了這個被棄用的修飾符, preg_replace() 在進行了對替換字符串的 后向引用替換之后, 將替換后的字符串作為php 代碼評估執行(eval 函數方式),並使用執行結果 作為實際參與替換的字符串。單引號、雙引號、反斜線(\)和 NULL 字符在 后向引用替換時會被用反斜線轉義.
Caution

The addslashes() function is run on each matched backreference before the substitution takes place. As such, when the backreference is used as a quoted string, escaped characters will be converted to literals. However, characters which are escaped, which would normally not be converted, will retain their slashes. This makes use of this modifier very complicated.

Caution

請確保 replacement 參數由合法 php 代碼字符串組成,否則 php 將會 在preg_replace() 調用的行上產生一個解釋錯誤。

Caution

不建議使用此修飾符,它很容易產生安全漏洞:

<?php
$html = $_POST['html'];

// uppercase headings
$html = preg_replace(
    '(<h([1-6])>(.*?)</h\1>)e',
    '"<h$1>" . strtoupper("$2") . "</h$1>"',
    $html
);

以上示例代碼能夠被這樣的字符串利用: <h1>{${eval($_GET[php_code])}}</h1>。 這能讓攻擊者執行他們想要的 PHP 代碼,幾乎完全滲透進服務器。

為了阻止此類遠程代碼執行攻擊,可以使用 preg_replace_callback() 替代:

<?php
$html = $_POST['html'];

// uppercase headings
$html = preg_replace_callback(
    '(<h([1-6])>(.*?)</h\1>)',
    function ($m) {
        return "<h$m[1]>" . strtoupper($m[2]) . "</h$m[1]>";
    },
    $html
);

Note:

僅 preg_replace() 使用此修飾符,其他 PCRE 函數忽略此修飾符。

A ( PCRE_ANCHORED)
如果設置了這個修飾符,模式被強制為"錨定"模式,也就是說約束匹配使其僅從 目標字符串的開始位置搜索。這個效果同樣可以使用適當的模式構造出來,並且 這也是 perl 種實現這種模式的唯一途徑。
D ( PCRE_DOLLAR_ENDONLY)
如果這個修飾符被設置,模式中的元字符美元符號僅僅匹配目標字符串的末尾。如果這個修飾符 沒有設置,當字符串以一個換行符結尾時, 美元符號還會匹配該換行符(但不會匹配之前的任何換行符)。 如果設置了修飾符m,這個修飾符被忽略. 在 perl 中沒有與此修飾符等同的修飾符。
S
當一個模式需要多次使用的時候,為了得到匹配速度的提升,值得花費一些時間 對其進行一些額外的分析。如果設置了這個修飾符,這個額外的分析就會執行。當前, 這種對一個模式的分析僅僅適用於非錨定模式的匹配(即沒有單獨的固定開始字符)。
U ( PCRE_UNGREEDY)
這個修飾符逆轉了量詞的"貪婪"模式。 使量詞默認為非貪婪的,通過量詞后緊跟? 的方式可以使其成為貪婪的。這和 perl 是不兼容的。 它同樣可以使用 模式內修飾符設置 (?U)進行設置, 或者在量詞后以問號標記其非貪婪(比如.*?)。

Note:

在非貪婪模式,通常不能匹配超過 pcre.backtrack_limit 的字符。

X ( PCRE_EXTRA)
這個修飾符打開了 PCRE 與 perl 不兼容的附件功能。模式中的任意反斜線后就 ingen 一個 沒有特殊含義的字符都會導致一個錯誤,以此保留這些字符以保證向后兼容性。 默認情況下,在 perl 中,反斜線緊跟一個沒有特殊含義的字符被認為是該字符的原文。 當前沒有其他特性由這個修飾符控制。
J ( PCRE_INFO_JCHANGED)
內部選項設置(?J)修改本地的PCRE_DUPNAMES選項。允許子組重名, (譯注:只能通過內部選項設置,外部的 /J 設置會產生錯誤。)
u ( PCRE_UTF8)
此修正符打開一個與 perl 不兼容的附加功能。 模式和目標字符串都被認為是 utf-8 的。 無效的目標字符串會導致 preg_* 函數什么都匹配不到; 無效的模式字符串會導致 E_WARNING 級別的錯誤。 PHP 5.3.4 后,5字節和6字節的 UTF-8 字符序列被考慮為無效(resp. PCRE 7.3 2007-08-28)。 以前就被認為是無效的 UTF-8。
轉自:http://php.net/manual/zh/reference.pcre.pattern.modifiers.php#reference.pcre.pattern.modifiers.eval


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM