Функция 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

  • $flags: flags можно установить в следующие значения флагов:

    1. PREG_OFFSET_CAPTURE: Если этот флаг передан, для каждого вхождения совпадения будет добавлено смещение строки (относительно целевой строки). Примечание: Это изменяет массив, заполняемый в параметр matches, делая каждый элемент массивом, где 0-й элемент — это совпавшая строка, а 1-й элемент — смещение этой совпавшей строки в целевой строке subject.

  • offset: Обычно поиск начинается с начала целевой строки. Необязательный параметр offset используется для указания начала поиска с определённой позиции в целевой строке (в байтах).

Возвращаемое значение

Возвращает количество совпадений для pattern. Его значение будет 0 (нет совпадений) или 1, потому что preg_match() прекращает поиск после первого совпадения. preg_match_all() отличается; он продолжает поиск в subject до достижения конца. Если возникает ошибка, preg_match() возвращает FALSE.

Примеры

Найти текстовую строку "php":

<?php //Символ 'i' после разделителя шаблона означает поиск без учета регистра. if (preg_match("/php/i", "PHP — это предпочтительный язык веб-скриптов.")) { echo "Совпадающая строка php найдена."; } else { echo "Совпадающая строка php не найдена."; } ?>

Результат выполнения выглядит следующим образом:

查找到匹配的字符串 php。


Найти слово "web"

<?php /*\b в шаблоне обозначает границу слова, поэтому будет найдено только отдельное слово "web", а не * части слова, такие как "webbing" или "cobweb"*/ if (preg_match("/\bweb\b/i", "PHP — это предпочтительный язык веб-скриптов.")) { echo "Совпадающая строка найдена.\n"; } else { echo "Совпадающая строка не найдена.\n"; } if (preg_match("/\bweb\b/i", "PHP — это предпочтительный язык сценариев для веб-сайтов.")) { echo "Совпадающая строка найдена.\n"; } else { echo "Совпадающая строка не найдена.\n"; } ?>

Результат выполнения выглядит следующим образом:

Matching string found.


Получить доменное имя из URL

<?php //Получить имя хоста из URL preg_match('@^(?:http://)?([^/]+)@i', "http://www.example.com/index.html", $matches); $host = $matches[1]; //Получить последние две части имени хоста preg_match('/[^.]+\.[^.]+$/', $host, $matches); echo "доменное имя: {$matches[0]}\n"; ?>

Результат выполнения выглядит следующим образом:

domain name is: example.com


Использование именованных подгрупп

<?php $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
)

Регулярные выражения PHP (PCRE)

Другие расширения