Mb eregi: примеры (PHP)

Простые примеры использования

Поиск слова независимо от регистра.

<?php
$string = 'Привет, мир!';
if (mb_eregi('мир', $string)) {
    echo 'Найдено';
} else {
    echo 'Не найдено';
}
?>

Найдено

Извлечение части строки.

<?php
$string = 'Иван Иванов';
$found = mb_eregi('иван', $string, $matches);
var_dump($found, $matches);
?>

bool(true)
array(1) {
  [0]=>
  string(8) "Иван"
}

Извлечение имени и фамилии.

<?php
$string = 'Анна Петрова';
mb_eregi('([а-я]+)\s+([а-я]+)', $string, $matches);
print_r($matches);
?>

Array
(
    [0] => Анна Петрова
    [1] => Анна
    [2] => Петрова
)

Похожие функции в PHP

Функция mb_ereg аналогична mb_eregi, но является регистрозависимой. Её предпочтительнее использовать, когда важно различать заглавные и строчные буквы.

Функция preg_match из расширения PCRE также поддерживает многобайтовые строки с модификатором u. Она часто работает быстрее и обладает более богатым синтаксисом регулярных выражений. Для регистронезависимого поиска используется модификатор i.

• mb_eregi/mb_ereg: Часть модуля mbstring, проще для базовых операций в известной кодировке.
• preg_match: Более современный и мощный инструмент, рекомендуется для новых проектов.

Типичные ошибки

Если внутренняя кодировка скрипта не совпадает с кодировкой строки, поиск может завершиться неудачей.

<?php
mb_internal_encoding('CP1251'); // Устанавливаем Windows-1251
$string = 'Тест'; // В UTF-8
$result = mb_eregi('тест', $string);
var_dump($result); // Возможен false или искаженный результат
?>

Вызов функции без установленного модуля mbstring вызовет фатальную ошибку.

mb_eregi использует синтаксис регулярных выражений POSIX, который отличается от синтаксиса PCRE (используемого в preg_match). Например, для обозначения границы слова в POSIX используется [[:<:]] и [[:>:]].

<?php
$string = 'слово тест слово';
// Неправильно для POSIX (это синтаксис PCRE):
$result = mb_eregi('\bтест\b', $string, $matches);
var_dump($result); // bool(false)
// Правильно для POSIX:
$result = mb_eregi('[[:<:]]тест[[:>:]]', $string, $matches);
var_dump($result, $matches);
?>

bool(false)
bool(true)
array(1) {
  [0]=>
  string(8) "тест"
}

Изменения в последних версиях PHP

Объявлена устаревшей (deprecated) функция mb_eregi, как и другие функции семейства ereg в модуле mbstring. Разработчикам рекомендуется переходить на использование функций PCRE (preg_match с модификатором i и u).

Вызов устаревших функций ereg из модуля mbstring по-прежнему возможен, но генерирует предупреждение об устаревании (E_DEPRECATED). Их планируется удалить в будущих основных версиях PHP.

Расширенные примеры

Функция mb_eregi находит только первое вхождение. Для поиска всех вхождений необходимо использовать цикл с mb_ereg_search.

<?php
mb_internal_encoding('UTF-8');
$string = 'Один два три два один';
$pattern = 'два';
$offset = 0;
$all_matches = [];
while (mb_eregi($pattern, $string, $matches, $offset)) {
    $all_matches[] = $matches[0];
    $pos = mb_strpos(mb_strtolower($string), mb_strtolower($matches[0]), $offset);
    $offset = $pos + mb_strlen($matches[0]);
}
print_r($all_matches);
?>

Array
(
    [0] => два
    [1] => два
)

<?php
$data = "Имя: Алексей\nФамилия: Сидоров\nГород: Москва";
mb_eregi('Имя:\s*([^\n]+)', $data, $name_match);
mb_eregi('Фамилия:\s*([^\n]+)', $data, $surname_match);
mb_eregi('Город:\s*([^\n]+)', $data, $city_match);

$person = [
    'name' => $name_match[1] ?? null,
    'surname' => $surname_match[1] ?? null,
    'city' => $city_match[1] ?? null
];
print_r($person);
?>

Array
(
    [name] => Алексей
    [surname] => Сидоров
    [city] => Москва
)

<?php
function isValidCyrillicName($name) {
    // Соответствует кириллическим буквам, дефису и пробелу
    return mb_eregi('^[А-ЯЁа-яё\-\s]+$', $name) === 1;
}

$names = ['Анна', 'Мария-Луиза', 'Иван Петров', 'John123'];
foreach ($names as $name) {
    echo $name . ': ' . (isValidCyrillicName($name) ? 'Да' : 'Нет') . "\n";
}
?>

Анна: Да
Мария-Луиза: Да
Иван Петров: Да
John123: Нет

Несмотря на то что вопрос о mb_eregi, стоит показать связанную функцию замены.

<?php
$text = 'цвет и колор';
// Заменяем оба варианта написания на 'color'
$newText = mb_eregi_replace('(цв[еэ]т|колор)', 'color', $text);
echo $newText;
?>

color и color

Аналоги в других языках

import re
string = 'Привет, мир!'
match = re.search('мир', string, re.IGNORECASE | re.UNICODE)
print(match is not None)
if match:
    print(match.group(0))

True
мир

const string = 'Привет, мир!';
const regex = /мир/ui;
const match = string.match(regex);
console.log(match !== null);
if (match) {
    console.log(match[0]);
}

true
мир

-- Предполагается, что коллация таблицы/столбца utf8mb4_unicode_ci
SELECT 'Привет, мир!' REGEXP 'МИР' as found;

found: 1