PHP str_contains(): verificare se una stringa contiene testo

str_contains($haystack, $needle) restituisce true se $needle compare in un punto qualsiasi di $haystack, e false altrimenti. È stata aggiunta in PHP 8.0 e distingue maiuscole e minuscole.

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

A differenza di strpos(), restituisce un vero booleano, quindi non c'è la trappola di "trovato alla posizione 0 sembra false".

Sintassi

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

Tutte e tre sono state aggiunte in PHP 8.0 e lavorano byte per byte, quindi gestiscono correttamente il giapponese e altro testo UTF-8 senza una versione mb_.

Verificare l'inizio o la fine con str_starts_with e 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

Contiene, senza distinzione tra maiuscole e minuscole

Non esiste str_icontains(). Converti prima entrambe le stringhe in minuscolo. mb_strtolower() converte in minuscolo anche le lettere non ASCII, come É o il cirillico, che strtolower() lascia invariate.

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

L'ago vuoto restituisce true

Un ago vuoto viene trovato in ogni stringa, anche in una vuota. Conta quando l'ago arriva da una casella di ricerca che l'utente ha lasciato vuota.

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

Verificare se una stringa contiene una o tutte tra più parole

str_contains() accetta un solo ago. Scorri un array di aghi: restituisci appena uno corrisponde per "almeno una", oppure appena uno fallisce per "tutte".

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

Per verificare se un valore è uno degli elementi di un array, invece che una sottostringa di una stringa, usa in_array().

Prima di PHP 8: strpos !== false

Il codice che deve girare su PHP 7 usa strpos() con un confronto stretto. Dà la stessa risposta di str_contains(), tranne che per un ago vuoto: lo strpos() di PHP 7 stampava Warning: strpos(): Empty needle e restituiva 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'));

L'ultima riga stampa bool(false) anche se il testo c'è, perché php si trova alla posizione 0. Sostituire questi controlli con str_contains() è uno degli aggiornamenti a PHP 8 più facili.