PHP 문자열이 포함되어 있는지 확인 str_contains 사용 방법

문자열 안에 특정 문자열이 포함되어 있는지 확인하는 방법 중 str_contains를 사용하는 방법을 알아보겠습니다.

str_contains는 PHP8 부터 사용가능한 함수입니다.

PHP8 이전 버전에서는 사용할 수 없습니다.

PHP8 이전 버전에서 문자열이 포함되어 있는지 확인하기 위해서는 preg_match() 함수를 사용합니다.

preg_match() 함수 사용법은 아래를 참조해 주세요.

알기 쉬운 PHP 정규식 표현 preg_match 함수 설명 및 링크링크

str_contains()

대상 문자열에 지정한 문자열이 있는지 확인하고 싶은 경우에 사용합니다.

작성 방법을 보겠습니다.

str_contains(대상 문자열, 지정 문자열)

대상 문자열에 검색하고 싶은 지정 문자열이 존재하는 경우에는 ture, 존재하지 않는 경우에는 false를 반환합니다.

문자열이 존재하는지 판별할 때 대소문자를 구분합니다.

샘플 코드를 보면서 str_contains 사용방법을 알아보겠습니다.

if (str_contains('Hello World', 'Hello')) {
	print 'Hello 포함되어 있습니다.';
}else{
	print 'Hello 포함되지 않았습니다.';
}

결과

Hello 포함되어 있습니다.

Hello World 대상 문자열에 지정한 문자열 Hello가 존재하기 때문에 true를 반환합니다.

이번에는 대상 문자열에서 World를 검색해 보겠습니다.

if (str_contains('Hello World', 'World')) {
	print 'World 포함되어 있습니다.';
}else{
	print 'World 포함되지 않았습니다.';
}

결과

World 포함되어 있습니다.

World라는 문자열도 대상 문자열에 포함되어 있기 때문에 true를 반환합니다.

샘플결과에서도 알 수 있듯이 대상 문자열과 완전 일치가 아닌 부분일치를 해도 true를 반환합니다.

마지막으로 대상 문자열에 지정한 문자열이 포함되지 않은 경우를 보겠습니다.

if (str_contains('Hello World', 'Apple')) {
	print 'Apple 포함되어 있습니다.';
}else{
	print 'Apple 포함되지 않았습니다.';
}

결과

Apple 포함되지 않았습니다.

대상 문자열에 Apple이라는 문자열은 존재하지 않기 때문에 false를 반환합니다.

PHP8 이전 환경에서 str_contains 사용하는 경우 에러가 발생하니 주의해야 합니다.

Fatal error: Uncaught Error: Call to undefined function str_contains() in ～