Submit a Pull Request Report a Bug

    str_contains

    (PHP 8)

    str_contains — Determine if a string contains a given substring

    Description

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

    Performs a case-sensitive check indicating if needle is contained in haystack.

    Liste de paramètres

    haystack

    The string to search in.

    needle

    The substring to search for in the haystack.

    Valeurs de retour

    Returns true if needle is in haystack, false otherwise.

    Exemples

    Exemple #1 Using the empty string ''

    <?php
    if (str_contains('abc', '')) {
        echo     "Checking the existence of the empty string will always return true";
    }
    ?>

    L'exemple ci-dessus va afficher :

    Checking the existence of the empty string will always return true

    Exemple #2 Showing case-sensitivity

    <?php
    $string     = 'The lazy fox jumped over the fence';

    if (    str_contains($string, 'lazy')) {
        echo     "The string 'lazy' was found in the string\n";
    }

    if (    str_contains($string, 'Lazy')) {
        echo     'The string "Lazy" was found in the string';
    } else {
        echo     '"Lazy" was not found because the case does not match';
    }

    ?>

    L'exemple ci-dessus va afficher :

    The string 'lazy' was found in the string
"Lazy" was not found because the case does not match

    Notes

    Note: Cette fonction gère les chaînes binaires.

    Voir aussi

    • str_ends_with() - Checks if a string ends with a given substring
    • str_starts_with() - Checks if a string starts with a given substring
    • stripos() - Recherche la position de la première occurrence dans une chaîne, sans tenir compte de la casse
    • strrpos() - Cherche la position de la dernière occurrence d'une sous-chaîne dans une chaîne
    • strripos() - Cherche la position de la dernière occurrence d'une chaîne contenue dans une autre, de façon insensible à la casse
    • strstr() - Trouve la première occurrence dans une chaîne
    • strpbrk() - Recherche un ensemble de caractères dans une chaîne de caractères
    • substr() - Retourne un segment de chaîne
    • preg_match() - Effectue une recherche de correspondance avec une expression rationnelle standard

    add a note add a note

    User Contributed Notes 4 notes

    up
    13
    scm6079
    3 years ago
    For earlier versions of PHP, you can polyfill the str_contains function using the following snippet:

    <?php
    // based on original work from the PHP Laravel framework
    if (!function_exists('str_contains')) {
        function     str_contains($haystack, $needle) {
            return     $needle !== '' && mb_strpos($haystack, $needle) !== false;
        }
    }
    ?>
    up
    2
    olivertasche+nospam at gmail dot com
    3 years ago
    The code from "me at daz dot co dot uk" will not work if the word is
    - at the start of the string
    - at the end of the string
    - at the end of a sentence (like "the ox." or "is that an ox?")
    - in quotes
    - and so on.

    You should explode the string by whitespace, punctations, ... and check if the resulting array contains your word OR try to test with a RegEx like this:
    (^|[\s\W])+word($|[\s\W])+

    Disclaimer: The RegEx may need some tweaks
    up
    -7
    kadenskinner at gmail dot com
    3 years ago
    <?php

    $needle     = '@';
    $haystack = 'user@example.com';

    if (!    str_contains($haystack, $needle)){
    echo     'There is not an @ in haystack';
    }else{
    echo     'There is an @ in haystack';
    }
    up
    -37
    me at daz dot co dot uk
    3 years ago
    # Watch out for aberrant partial matches

    $string = 'The lazy fox jumped over the fence';

    if (str_contains($string, 'ox')) {
        echo 'The string "ox" was found in the string because it was a partial match';
    } else {
        echo '"ox" was not found';
    }
    //output: The string "ox" was found in the string because it was a partial match

    # use spaces for full word matching

    $string = 'The lazy fox jumped over the fence';

    if (str_contains($string, ' ox ')) {
        echo 'The string " ox " was found in the string because it was a partial match';
    } else {
        echo '" ox " was not found';
    }
    //output:  " ox " was not found
    add a note add a note
    To Top