PHP strpos(): die Position eines Teilstrings finden

strpos($haystack, $needle) liefert die Position des ersten $needle in $haystack, ab 0 gezählt, oder false, wenn es nicht vorkommt. Prüfe das Ergebnis immer mit !== false, denn ein Treffer am Anfang liefert 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";
}

Wenn du unter PHP 8 nur eine Ja-oder-Nein-Antwort brauchst, ist str_contains() klarer. Verwende strpos(), wenn die Position zählt.

Syntax

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

Die Suche unterscheidet Groß- und Kleinschreibung. $offset gibt an, wo die Suche beginnt; ein negativer Offset zählt vom Ende des Strings.

Die Falle !== false

0 und false sind beim lockeren Vergleich (==) gleich. Ein Treffer an Position 0 wird deshalb von jeder nicht strikten Prüfung als „nicht gefunden“ behandelt.

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

Dieselbe Regel gilt für stripos(), strrpos() und array_search(), die alle für einen echten Treffer 0 liefern können.

Suche ohne Groß- und Kleinschreibung mit stripos

stripos() nimmt dieselben Argumente und ignoriert die Schreibweise von ASCII-Buchstaben.

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

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

Das letzte Vorkommen mit strrpos finden

strrpos() liefert die Position des letzten Treffers. Das ist der Standardweg, eine Dateiendung oder das letzte Segment eines Pfads zu holen.

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

Speziell für Dateinamen erledigt pathinfo($file, PATHINFO_EXTENSION) das für dich. Wie man den String an der Position schneidet, steht auf der Seite zu substr().

Die Suche an einem Offset beginnen

Das dritte Argument überspringt den Anfang des Strings. Ein negativer Offset beginnt so viele Zeichen vor dem Ende.

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

Alle Vorkommen finden

strpos() findet einen Treffer. Iteriere und schiebe den Offset hinter jeden Treffer, um alle zu finden:

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

Nur die Anzahl? substr_count($text, 'the') ist kürzer. Für Muster liefert preg_match_all() mit PREG_OFFSET_CAPTURE jeden Treffer mit seiner Position.

Japanischer Text: Byte-Position vs Zeichenposition

strpos() findet Multibyte-Text korrekt, aber die Zahl, die es liefert, ist in Bytes. Kana und gängige Kanji brauchen in UTF-8 je 3 Bytes, also ist in rein japanischem Text die Byte-Position das Dreifache der Zeichenposition, und in gemischtem Text laufen die beiden auf weniger offensichtliche Weise auseinander. mb_strpos() liefert Zeichen, und das erwartet 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";

Die beiden zu mischen ist ein klassischer Bug: Ein Ergebnis von strpos() an mb_substr() zu übergeben, beginnt zu weit hinten im String. Verwende strpos mit substr und mb_strpos mit mb_substr.