PHP strpos(): Bir Alt Dizgenin Konumunu Bulma

strpos($haystack, $needle) $haystack içindeki ilk $needle değerinin 0'dan sayılan konumunu, orada değilse false döndürür. Sonucu her zaman !== false ile test edin, çünkü baştaki bir eşleşme 0 döndürür.

<?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'de yalnızca evet veya hayır yanıtına ihtiyacınız varsa str_contains() daha açıktır. Konum önemli olduğunda strpos() kullanın.

Söz dizimi

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

Arama büyük küçük harfe duyarlıdır. $offset aramaya nereden başlanacağını söyler; negatif bir başlangıç dizgenin sonundan sayar.

!== false tuzağı

Gevşek karşılaştırmada (==) 0 ve false eşittir. Bu yüzden 0 konumundaki bir eşleşme katı olmayan her kontrolde "bulunamadı" sayılır.

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

Aynı kural, gerçek bir eşleşme için hepsi 0 döndürebilen stripos(), strrpos() ve array_search() için de geçerlidir.

stripos ile büyük küçük harfe duyarsız arama

stripos() aynı argümanları alır ve ASCII harflerde büyük küçük harfi yok sayar.

<?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 ile son geçişi bulma

strrpos() son eşleşmenin konumunu döndürür. Bir dosya uzantısını veya bir yolun son parçasını almanın standart yoludur.

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

Özellikle dosya adları için pathinfo($file, PATHINFO_EXTENSION) bunu sizin yerinize yapar. Dizgeyi o konumda kesmek substr() sayfasında anlatılıyor.

Aramayı bir başlangıç noktasından başlatma

Üçüncü argüman dizgenin başını atlar. Negatif bir başlangıç sondan o kadar karakter önce başlar.

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

Tüm geçişleri bulma

strpos() bir eşleşme bulur. Hepsini bulmak için bir döngü kurun ve başlangıcı her eşleşmenin ötesine taşıyın:

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

Yalnızca sayı mı lazım? substr_count($text, 'the') daha kısadır. Kalıplar için PREG_OFFSET_CAPTURE ile preg_match_all() her eşleşmeyi konumuyla döndürür.

Japonca metin: bayt konumu ve karakter konumu

strpos() çok baytlı metni doğru bulur, ama döndürdüğü sayı bayt cinsindendir. UTF-8'de kana ve yaygın kanji karakterleri 3'er bayt kaplar, bu yüzden tamamen Japonca bir metinde bayt konumu karakter konumunun üç katıdır, karışık metinde ise ikisi daha az belirgin şekillerde birbirinden uzaklaşır. mb_strpos() karakter döndürür ve mb_substr() bunu bekler.

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

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

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

İkisini karıştırmak klasik bir hatadır: bir strpos() sonucunu mb_substr() fonksiyonuna vermek dizgenin çok ilerisinden başlar. strpos ile substr, mb_strpos ile mb_substr kullanın.