PHP str_contains(): prüfen, ob ein String Text enthält

str_contains($haystack, $needle) liefert true, wenn $needle irgendwo in $haystack vorkommt, und sonst false. Es kam mit PHP 8.0 und unterscheidet Groß- und Kleinschreibung.

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

Anders als strpos() liefert es einen echten Boolean, also gibt es keine Falle nach dem Muster „an Position 0 gefunden sieht aus wie false“.

Syntax

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

Alle drei kamen mit PHP 8.0 und arbeiten Byte für Byte, kommen also ohne mb_-Version korrekt mit Japanisch und anderem UTF-8-Text zurecht.

Anfang oder Ende mit str_starts_with und str_ends_with prüfen

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

Enthält, ohne Groß- und Kleinschreibung

Es gibt kein str_icontains(). Wandle zuerst beide Strings in Kleinbuchstaben um. mb_strtolower() macht auch Buchstaben außerhalb von ASCII klein, etwa É oder Kyrillisch, die strtolower() unverändert lässt.

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

Der leere Suchstring liefert true

Ein leerer Suchstring wird in jedem String gefunden, auch in einem leeren. Das zählt, wenn der Suchstring aus einem Suchfeld kommt, das der Nutzer leer gelassen hat.

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

Prüfen, ob ein String eines oder alle von mehreren Wörtern enthält

str_contains() nimmt einen Suchstring. Iteriere über ein Array von Suchstrings: Gib zurück, sobald einer passt, für „irgendeiner“, oder sobald einer nicht passt, für „alle“.

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

Um zu prüfen, ob ein Wert eines der Elemente eines Arrays ist, statt ein Teilstring eines Strings, verwendest du in_array().

Vor PHP 8: strpos !== false

Code, der unter PHP 7 laufen muss, verwendet strpos() mit striktem Vergleich. Es liefert dieselbe Antwort wie str_contains(), außer bei einem leeren Suchstring: Das strpos() von PHP 7 gab Warning: strpos(): Empty needle aus und lieferte 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'));

Die letzte Zeile gibt bool(false) aus, obwohl der Text da ist, weil php an Position 0 steht. Solche Prüfungen durch str_contains() zu ersetzen, ist eines der einfachsten Upgrades auf PHP 8.