PHP strpos(): 문자열 위치 찾기와 검색

strpos($haystack, $needle)는 $haystack 안에서 첫 번째 $needle의 위치를 0부터 세어 반환하고, 없으면 false를 반환합니다. 처음에서 일치하면 0을 반환하므로 결과는 항상 !== false로 확인하세요.

<?php
$text = 'apple, banana, cherry';

var_dump(strpos($text, 'banana'));   // found at position 7
var_dump(strpos($text, 'apple'));    // found at position 0
var_dump(strpos($text, 'grape'));    // not found

if (strpos($text, 'apple') !== false) {
    echo "Found apple\n";
}

PHP 8에서 예, 아니요만 필요하다면 str_contains()가 더 명확합니다. 위치가 중요할 때 strpos()를 쓰세요.

문법

strpos(string $haystack, string $needle, int $offset = 0): int|false

검색은 대소문자를 구분합니다. $offset은 어디서부터 찾을지 알려 주며, 음수 오프셋은 문자열 끝에서부터 셉니다.

!== false 함정

느슨한 비교(==)에서 0과 false는 같습니다. 그래서 엄격하지 않은 확인은 위치 0의 일치를 "찾지 못함"으로 취급합니다.

<?php
$url = 'https://example.com';

// Wrong: position 0 is falsy, so this says "no"
if (strpos($url, 'https')) {
    echo "wrong check: has https\n";
} else {
    echo "wrong check: no https\n";
}

// Right: compare strictly with false
if (strpos($url, 'https') !== false) {
    echo "right check: has https\n";
}

같은 규칙이 stripos(), strrpos(), array_search()에도 적용되며, 모두 실제 일치에 대해 0을 반환할 수 있습니다.

stripos로 대소문자 무시 검색

stripos()는 같은 인수를 받고 ASCII 문자의 대소문자를 무시합니다.

<?php
$title = 'Learning PHP the Hard Way';

var_dump(strpos($title, 'php'));    // case-sensitive: not found
var_dump(stripos($title, 'php'));   // found at 9

strrpos로 마지막 일치 찾기

strrpos()는 마지막 일치의 위치를 반환합니다. 파일 확장자나 경로의 마지막 부분을 얻는 표준적인 방법입니다.

<?php
$file = 'archive.backup.tar.gz';

$dot = strrpos($file, '.');
echo substr($file, $dot + 1), "\n";      // gz
echo substr($file, 0, $dot), "\n";       // archive.backup.tar

$path = '/var/www/html/index.php';
echo substr($path, strrpos($path, '/') + 1), "\n";

파일 이름이라면 pathinfo($file, PATHINFO_EXTENSION)이 이 일을 대신합니다. 위치에서 문자열을 자르는 방법은 substr() 페이지에서 다룹니다.

오프셋에서 검색 시작하기

세 번째 인수는 문자열의 앞부분을 건너뜁니다. 음수 오프셋은 끝에서 그만큼 앞에서 시작합니다.

<?php
$s = 'one two one two';

var_dump(strpos($s, 'one'));        // 0
var_dump(strpos($s, 'one', 1));     // skip position 0: finds the second one
var_dump(strpos($s, 'two', -3));    // search only the last 3 characters

모든 위치 찾기

strpos()는 일치 하나를 찾습니다. 모두 찾으려면 반복하면서 매번 일치 뒤로 오프셋을 옮기세요.

<?php
$text = 'the cat sat on the mat with the hat';
$needle = 'the';

$positions = [];
$offset = 0;
while (($pos = strpos($text, $needle, $offset)) !== false) {
    $positions[] = $pos;
    $offset = $pos + strlen($needle);
}

print_r($positions);
echo count($positions), " matches\n";

개수만 필요하다면 substr_count($text, 'the')가 더 짧습니다. 패턴이라면 PREG_OFFSET_CAPTURE와 함께 쓰는 preg_match_all()이 모든 일치를 위치와 함께 반환합니다.

일본어 텍스트: 바이트 위치와 문자 위치

strpos()는 멀티바이트 텍스트를 올바르게 찾지만, 반환하는 숫자는 바이트 단위입니다. UTF-8에서 가나와 일반 한자(한글도)는 각각 3바이트이므로, 모두 일본어인 텍스트에서는 바이트 위치가 문자 위치의 세 배이고, 섞인 텍스트에서는 둘이 덜 분명한 방식으로 어긋납니다. mb_strpos()는 mb_substr()가 기대하는 문자 단위를 반환합니다.

<?php
$s = '東京都渋谷区';

var_dump(strpos($s, '渋谷'));      // byte position
var_dump(mb_strpos($s, '渋谷'));   // character position

echo mb_substr($s, mb_strpos($s, '渋谷')), "\n";

둘을 섞는 것은 고전적인 버그입니다. strpos()의 결과를 mb_substr()에 넘기면 문자열의 너무 뒤쪽에서 시작합니다. strpos는 substr와, mb_strpos는 mb_substr와 함께 쓰세요.