PHP strpos(): Mencari Posisi Substring dalam String

strpos($haystack, $needle) mengembalikan posisi $needle pertama di dalam $haystack, dihitung dari 0, atau false kalau tidak ada. Selalu periksa hasilnya dengan !== false, karena kecocokan di awal string mengembalikan 0.

<?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";
}

Kalau di PHP 8 kamu hanya butuh jawaban ya atau tidak, str_contains() lebih jelas. Pakai strpos() kalau posisinya penting.

Sintaks

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

Pencariannya peka huruf besar kecil. $offset menentukan dari mana pencarian dimulai; offset negatif dihitung dari akhir string.

Jebakan !== false

0 dan false dianggap sama pada perbandingan longgar (==). Karena itu, kecocokan di posisi 0 dianggap "tidak ditemukan" oleh pemeriksaan apa pun yang tidak ketat.

<?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";
}

Aturan yang sama berlaku untuk stripos(), strrpos(), dan array_search(), yang semuanya bisa mengembalikan 0 untuk kecocokan yang sebenarnya.

Pencarian tanpa peka huruf besar kecil dengan stripos

stripos() menerima argumen yang sama dan mengabaikan huruf besar kecil pada huruf 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

Mencari kemunculan terakhir dengan strrpos

strrpos() mengembalikan posisi kecocokan terakhir. Inilah cara standar untuk mendapatkan ekstensi file atau bagian terakhir sebuah path.

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

Khusus untuk nama file, pathinfo($file, PATHINFO_EXTENSION) sudah melakukannya untukmu. Cara memotong string di posisi tertentu dibahas di halaman substr().

Memulai pencarian dari sebuah offset

Argumen ketiga melewati bagian awal string. Offset negatif memulai pencarian sejumlah karakter itu sebelum akhir string.

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

Menemukan semua kemunculan

strpos() hanya menemukan satu kecocokan. Pakai loop dan geser offset melewati setiap kecocokan untuk menemukan semuanya:

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

Hanya butuh jumlahnya? substr_count($text, 'the') lebih singkat. Untuk pola, preg_match_all() dengan PREG_OFFSET_CAPTURE mengembalikan setiap kecocokan beserta posisinya.

Teks Jepang: posisi byte vs posisi karakter

strpos() menemukan teks multibyte dengan benar, tetapi angka yang dikembalikannya dalam byte. Kana dan kanji umum masing-masing memakai 3 byte di UTF-8, jadi pada teks yang seluruhnya berbahasa Jepang, posisi byte adalah tiga kali posisi karakter, dan pada teks campuran keduanya bergeser dengan cara yang tidak terlalu kelihatan. mb_strpos() mengembalikan posisi dalam karakter, dan itulah yang diharapkan 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";

Mencampur keduanya adalah bug klasik: memberikan hasil strpos() ke mb_substr() membuat potongannya dimulai terlalu jauh ke dalam string. Pakai strpos dengan substr, dan mb_strpos dengan mb_substr.