PHP str_contains(): 문자열 포함 여부 확인

str_contains($haystack, $needle)는 $needle이 $haystack 어딘가에 있으면 true, 아니면 false를 반환합니다. PHP 8.0에서 추가되었으며 대소문자를 구분합니다.

<?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()와 달리 진짜 불리언을 반환하므로 "위치 0에서 찾았는데 false처럼 보이는" 함정이 없습니다.

문법

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

셋 다 PHP 8.0에서 추가되었고 바이트 단위로 동작하므로, mb_ 버전 없이도 한글, 일본어 등 UTF-8 텍스트를 올바르게 처리합니다.

str_starts_with와 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

대소문자를 무시하는 포함 확인

str_icontains()는 없습니다. 먼저 두 문자열을 소문자로 바꾸세요. mb_strtolower()는 strtolower()가 그대로 두는 É나 키릴 문자처럼 ASCII 밖의 문자도 소문자로 바꿉니다.

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

빈 문자열은 true를 반환한다

빈 문자열은 빈 문자열을 포함해 모든 문자열에서 발견됩니다. 사용자가 비워 둔 검색창에서 찾는 값이 올 때 문제가 됩니다.

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

여러 단어 중 하나 또는 모두 포함하는지 확인하기

str_contains()는 찾는 값을 하나만 받습니다. 찾는 값 배열을 반복하세요. "하나라도"라면 하나가 일치하는 즉시, "모두"라면 하나가 실패하는 즉시 반환합니다.

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

문자열의 부분 문자열이 아니라 값이 배열의 요소 중 하나인지 확인하려면 in_array()를 쓰세요.

PHP 8 이전: strpos !== false

PHP 7에서도 실행되어야 하는 코드는 엄격한 비교와 함께 strpos()를 씁니다. 빈 문자열을 찾는 경우만 빼면 str_contains()와 같은 답을 줍니다. PHP 7의 strpos()는 Warning: strpos(): Empty needle을 출력하고 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'));

텍스트가 있는데도 마지막 줄은 bool(false)를 출력합니다. php가 위치 0에 있기 때문입니다. 이런 확인을 str_contains()로 바꾸는 것은 가장 쉬운 PHP 8 업그레이드 중 하나입니다.