strpos() ב-PHP: מציאת המיקום של תת מחרוזת

strpos($haystack, $needle) מחזירה את המיקום של $needle הראשונה בתוך $haystack, שנספר מ-0, או false אם היא לא שם. תמיד בדקו את התוצאה עם !== false, כי התאמה בהתחלה מחזירה 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";
}

אם אתם צריכים רק תשובה של כן או לא ב-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_match_all() עם PREG_OFFSET_CAPTURE מחזירה כל התאמה עם המיקום שלה.

טקסט ביפנית: מיקום בבתים מול מיקום בתווים

strpos() מוצאת טקסט מרובה בתים נכון, אבל המספר שהיא מחזירה הוא בבתים. קאנה וקאנג'י נפוצים תופסים 3 בתים כל אחד ב-UTF-8, ולכן בטקסט יפני מלא המיקום בבתים הוא פי שלושה מהמיקום בתווים, ובטקסט מעורב השניים מתרחקים זה מזה בדרכים פחות ברורות. 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.