PHP str_contains(): Bir Dizge Metin İçeriyor mu Kontrolü

str_contains($haystack, $needle) $needle değeri $haystack içinde herhangi bir yerde geçiyorsa true, aksi halde false döndürür. PHP 8.0'da eklendi ve büyük küçük harfe duyarlıdır.

<?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";
}

strpos() fonksiyonundan farklı olarak gerçek bir boolean döndürür, bu yüzden "0 konumunda bulundu, false gibi görünüyor" tuzağı yoktur.

Söz dizimi

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

Üçü de PHP 8.0'da eklendi ve bayt bayt çalışır, bu yüzden Japonca ve diğer UTF-8 metinleri bir mb_ sürümüne gerek kalmadan doğru işler.

str_starts_with ve str_ends_with ile başı veya sonu kontrol etme

<?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

Büyük küçük harfe duyarsız içerme

str_icontains() diye bir fonksiyon yoktur. Önce iki dizgeyi de küçük harfe çevirin. mb_strtolower(), strtolower() fonksiyonunun dokunmadığı É veya Kiril harfleri gibi ASCII dışındaki harfleri de küçük harfe çevirir.

<?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

Boş aranan değer true döndürür

Boş bir aranan değer, boş olan dahil her dizgede bulunur. Bu, aranan değer kullanıcının boş bıraktığı bir arama kutusundan geldiğinde önemlidir.

<?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);

Bir dizgenin birkaç kelimeden herhangi birini veya hepsini içerip içermediğini kontrol etme

str_contains() tek bir aranan değer alır. Bir aranan değerler dizisi üzerinde dolaşın: "herhangi biri" için biri eşleşir eşleşmez, "hepsi" için biri başarısız olur olmaz dönün.

<?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

Bir değerin bir dizgenin alt dizgesi değil de bir dizinin elemanlarından biri olup olmadığını kontrol etmek için in_array() kullanın.

PHP 8 öncesi: strpos !== false

PHP 7'de çalışması gereken kodlar katı bir karşılaştırmayla strpos() kullanır. Boş bir aranan değer dışında str_contains() ile aynı yanıtı verir: PHP 7'nin strpos() fonksiyonu Warning: strpos(): Empty needle yazdırır ve false döndürürdü.

<?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'));

Son satır, metin orada olduğu halde bool(false) yazdırır, çünkü php 0 konumundadır. Bu tür kontrolleri str_contains() ile değiştirmek en kolay PHP 8 yükseltmelerinden biridir.