PHP str_contains(): kiểm tra chuỗi có chứa chuỗi con

str_contains($haystack, $needle) trả về true nếu $needle xuất hiện ở bất kỳ đâu trong $haystack, ngược lại trả về false. Hàm này có từ PHP 8.0 và phân biệt chữ hoa chữ thường.

<?php
$sentence = 'The quick brown fox';

var_dump(str_contains($sentence, 'quick'));   // true
var_dump(str_contains($sentence, 'Quick'));   // false: case-sensitive
var_dump(str_contains($sentence, 'dog'));     // false

if (str_contains($sentence, 'fox')) {
    echo "Found a fox\n";
}

Khác với strpos(), hàm này trả về một giá trị boolean thật sự, nên không có cái bẫy "tìm thấy ở vị trí 0 trông giống như false".

Cú pháp

str_contains(string $haystack, string $needle): bool
str_starts_with(string $haystack, string $needle): bool
str_ends_with(string $haystack, string $needle): bool

Cả ba hàm đều được thêm vào từ PHP 8.0 và làm việc theo từng byte, nên chúng xử lý đúng tiếng Việt, tiếng Nhật và văn bản UTF-8 khác mà không cần phiên bản mb_.

Kiểm tra phần đầu hoặc phần cuối với str_starts_with và str_ends_with

<?php
$url = 'https://example.com/report.pdf';

var_dump(str_starts_with($url, 'https://'));   // true
var_dump(str_ends_with($url, '.pdf'));         // true
var_dump(str_ends_with($url, '.PDF'));         // false

$name = '株式会社コディ';
var_dump(str_starts_with($name, '株式会社'));   // true

Kiểm tra chứa chuỗi không phân biệt hoa thường

Không có hàm str_icontains(). Hãy chuyển cả hai chuỗi sang chữ thường trước. mb_strtolower() còn chuyển được cả các chữ cái ngoài bảng ASCII, như É, chữ có dấu tiếng Việt hay chữ Kirin, những chữ mà strtolower() bỏ qua.

<?php
function containsIgnoreCase(string $haystack, string $needle): bool
{
    return str_contains(mb_strtolower($haystack), mb_strtolower($needle));
}

var_dump(containsIgnoreCase('Learning PHP', 'php'));       // true
var_dump(containsIgnoreCase('ÉCOLE DE CODE', 'école'));    // true

// The same check with stripos (ASCII letters only)
var_dump(stripos('Learning PHP', 'php') !== false);        // true

Chuỗi cần tìm rỗng trả về true

Một chuỗi cần tìm rỗng được tìm thấy trong mọi chuỗi, kể cả chuỗi rỗng. Điều này quan trọng khi chuỗi cần tìm đến từ một ô tìm kiếm mà người dùng để trống.

<?php
var_dump(str_contains('abc', ''));    // true
var_dump(str_contains('', ''));       // true

$search = '';   // a blank search field
$title = 'PHP str_contains';
$matches = $search !== '' && str_contains($title, $search);
var_dump($matches);

Kiểm tra chuỗi có chứa một hay tất cả trong nhiều từ

str_contains() chỉ nhận một chuỗi cần tìm. Hãy duyệt qua một mảng các chuỗi cần tìm: trả về ngay khi có một từ khớp với trường hợp "một trong số", hoặc ngay khi có một từ không khớp với trường hợp "tất cả".

<?php
function containsAny(string $haystack, array $needles): bool
{
    foreach ($needles as $needle) {
        if (str_contains($haystack, $needle)) {
            return true;
        }
    }
    return false;
}

function containsAll(string $haystack, array $needles): bool
{
    foreach ($needles as $needle) {
        if (!str_contains($haystack, $needle)) {
            return false;
        }
    }
    return true;
}

$comment = 'Buy cheap watches now';

var_dump(containsAny($comment, ['cheap', 'free', 'winner']));   // true
var_dump(containsAll($comment, ['cheap', 'free']));             // false

Để kiểm tra một giá trị có phải là một phần tử của mảng hay không, thay vì là chuỗi con của một chuỗi, hãy dùng in_array().

Trước PHP 8: strpos !== false

Code phải chạy trên PHP 7 dùng strpos() với phép so sánh chặt. Kết quả giống hệt str_contains(), trừ trường hợp chuỗi cần tìm rỗng: strpos() của PHP 7 in ra Warning: strpos(): Empty needle và trả về false.

<?php
$haystack = 'php is fun';

var_dump(str_contains($haystack, 'php'));       // PHP 8
var_dump(strpos($haystack, 'php') !== false);   // PHP 7 and later

// The bug to avoid: position 0 is falsy
var_dump((bool) strpos($haystack, 'php'));

Dòng cuối in ra bool(false) dù đoạn văn bản có ở đó, vì php nằm ở vị trí 0. Thay những phép kiểm tra như vậy bằng str_contains() là một trong những nâng cấp lên PHP 8 dễ nhất.