PHP str_contains(): comprobar si un string contiene texto

str_contains($haystack, $needle) devuelve true si $needle aparece en cualquier lugar de $haystack, y false en caso contrario. Se añadió en PHP 8.0 y distingue mayúsculas y minúsculas.

<?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 diferencia de strpos(), devuelve un booleano real, así que no existe la trampa de "encontrado en la posición 0 parece false".

Sintaxis

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

Las tres se añadieron en PHP 8.0 y trabajan byte a byte, así que manejan correctamente el japonés y otro texto UTF-8 sin necesidad de una versión mb_.

Comprobar el principio o el final con str_starts_with y 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 sin distinguir mayúsculas y minúsculas

No existe str_icontains(). Pasa primero las dos cadenas a minúsculas. mb_strtolower() también pasa a minúsculas letras fuera de ASCII, como É o el cirílico, que strtolower() deja intactas.

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

La aguja vacía devuelve true

Una aguja vacía se encuentra en cualquier cadena, incluida una vacía. Esto importa cuando la aguja viene de un buscador que el usuario dejó en blanco.

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

Comprobar si una cadena contiene alguna o todas de varias palabras

str_contains() acepta una sola aguja. Recorre un array de agujas: devuelve en cuanto una coincida para "alguna", o en cuanto una falle para "todas".

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

Para comprobar si un valor es uno de los elementos de un array, y no una subcadena de una cadena, usa in_array().

Antes de PHP 8: strpos !== false

El código que tiene que funcionar en PHP 7 usa strpos() con una comparación estricta. Da la misma respuesta que str_contains(), salvo con una aguja vacía: el strpos() de PHP 7 imprimía Warning: strpos(): Empty needle y devolvía 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'));

La última línea imprime bool(false) aunque el texto está ahí, porque php está en la posición 0. Sustituir esas comprobaciones por str_contains() es una de las mejoras más fáciles al pasar a PHP 8.