preg_match()

(PHP 4, PHP 5, PHP 7)

执行匹配正则表达式

说明

搜索$subject与$pattern给定的正则表达式的一个匹配.

参数

要搜索的模式，字符串类型。

输入字符串。

如果提供了参数$matches，它将被填充为搜索结果。$matches[0]将包含完整模式匹配到的文本，$matches[1]将包含第一个捕获子组匹配到的文本，以此类推。

$flags可以被设置为以下标记值：PREG_OFFSET_CAPTURE

如果传递了这个标记，对于每一个出现的匹配返回时会附加字符串偏移量(相对于目标字符串的)。注意：这会改变填充到$matches参数的数组，使其每个元素成为一个由第0个元素是匹配到的字符串，第1个元素是该匹配字符串在目标字符串$subject中的偏移量。

以上例程会输出：

Array
(
    [0] => Array
        (
            [0] => foobarbaz
            [1] => 0
        )
    [1] => Array
        (
            [0] => foo
            [1] => 0
        )
    [2] => Array
        (
            [0] => bar
            [1] => 3
        )
    [3] => Array
        (
            [0] => baz
            [1] => 6
        )
)

通常，搜索从目标字符串的开始位置开始。可选参数$offset用于指定从目标字符串的某个位置开始搜索(单位是字节)。

Note:

使用$offset参数不同于向preg_match()传递按照位置通过substr($subject,$offset)截取目标字符串结果，因为$pattern可以包含断言比如^，$或者(?

以上例程会输出：

返回值

preg_match()返回$pattern的匹配次数。它的值将是0次（不匹配）或1次，因为preg_match()在第一次匹配后将会停止搜索。preg_match_all()不同于此，它会一直搜索$subject直到到达结尾。如果发生错误preg_match()返回FALSE。

更新日志

范例

查找文本字符串"php"

查找单词"word"

获取URL中的域名

以上例程会输出：

domain name is: php.net

使用命名子组

以上例程会输出：

Array
(
    [0] => foobar: 2008
    [name] => foobar
    [1] => foobar
    [digit] => 2008
    [2] => 2008
)

注释

如果你仅仅想要检查某个字符串是否包含另外一个字符串，不要使用preg_match()。使用strpos()会更快。

参见

• PCRE 模式
• preg_quote()转义正则表达式字符
• preg_match_all()执行一个全局正则表达式匹配
• preg_replace()执行一个正则表达式的搜索和替换
• preg_split()通过一个正则表达式分隔字符串
• preg_last_error()返回最后一个PCRE正则执行产生的错误代码

Simple regex
Regex quick reference
[abc]   A single character: a, b or c
[^abc]   Any single character but a, b, or c
[a-z]   Any single character in the range a-z
[a-zA-Z]   Any single character in the range a-z or A-Z
^   Start of line
$   End of line
\A   Start of string
\z   End of string
.   Any single character
\s   Any whitespace character
\S   Any non-whitespace character
\d   Any digit
\D   Any non-digit
\w   Any word character (letter, number, underscore)
\W   Any non-word character
\b   Any word boundary character
(...)   Capture everything enclosed
(a|b)   a or b
a?   Zero or one of a
a*   Zero or more of a
a+   One or more of a
a{3}   Exactly 3 of a
a{3,}   3 or more of a
a{3,6}   Between 3 and 6 of a
options: i case insensitive m make dot match newlines x ignore whitespace in regex o perform #{...} substitutions only once

Was working on a site that needed japanese and alphabetic letters and needed to 
validate input using preg_match, I tried using \p{script} but didn't work:

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com