Как проверить, начинается ли строка с заданной подстроки в PHP?

Использование str_starts_with() (PHP 8.0+)

Начиная с PHP 8.0, появилась встроенная функция str_starts_with(), которая идеально подходит для этой задачи. Она принимает два аргумента: исходную строку и подстроку для проверки. Возвращает true, если строка начинается с заданной подстроки, и false в противном случае.

<?php
$filename = "report_2023.pdf";

if (str_starts_with($filename, "report_")) {
    echo "Файл начинается с 'report_'";
} else {
    echo "Файл не начинается с 'report_'";
}
// Вывод: Файл начинается с 'report_'
?>

Функция чувствительна к регистру. Если вам нужно проверять без учёта регистра, используйте str_starts_with(strtolower($string), strtolower($prefix)).

Решение для старых версий PHP (7.x и ниже) — substr()

Если вы работаете с PHP 7 или более ранней версией, используйте substr() для сравнения первых N символов:

<?php
$filename = "report_2023.pdf";
$prefix = "report_";

if (substr($filename, 0, strlen($prefix)) === $prefix) {
    echo "Файл начинается с 'report_'";
}
?>

Объяснение:

• substr($filename, 0, strlen($prefix)) — извлекает из строки $filename первые символы, количество которых равно длине искомого префикса.
• Оператор === проверяет строгое равенство (тип и значение).

Альтернатива: strncmp() (для бинарно-безопасного сравнения)

Функция strncmp() сравнивает первые N символов двух строк. Она также чувствительна к регистру и работает быстрее substr(), так как не создаёт новую строку, а сравнивает напрямую:

<?php
$filename = "report_2023.pdf";
$prefix = "report_";

if (strncmp($filename, $prefix, strlen($prefix)) === 0) {
    echo "Файл начинается с 'report_'";
}
?>

Важно: strncmp() возвращает 0, если строки равны (первые N символов). Возвращает отрицательное или положительное число при неравенстве.

Для проверки без учёта регистра

Используйте strncasecmp() — аналог strncmp(), но без учёта регистра:

<?php
$filename = "Report_2023.pdf";
$prefix = "report_";

if (strncasecmp($filename, $prefix, strlen($prefix)) === 0) {
    echo "Начинается с 'report_' (без учёта регистра)";
}
?>

Рекомендации по выбору

• PHP 8.0+: используйте str_starts_with() — это самый читаемый и современный способ.
• PHP 7.x: используйте strncmp() — он быстрее и не создаёт лишних строк.
• Избегайте strpos() === 0 — это работает, но может ввести в заблуждение (проверяет позицию, а не начало).

<?php
$filename = "report_2023.pdf";

if (preg_match('/^report_/', $filename)) {
    echo "Начинается с 'report_'";
}
?>

<?php
function startsWith($string, $prefix) {
    return strncmp($string, $prefix, strlen($prefix)) === 0;
}

$files = ["report_1.pdf", "report_2.pdf", "invoice_1.pdf"];
foreach ($files as $file) {
    if (startsWith($file, "report_")) {
        echo "$file — это отчёт\n";
    }
}
?>