PHP strpos(): encontrar la posición de una subcadena

strpos($haystack, $needle) devuelve la posición del primer $needle dentro de $haystack, contando desde 0, o false si no está. Comprueba siempre el resultado con !== false, porque una coincidencia al principio devuelve 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";
}

Si en PHP 8 solo necesitas un sí o un no, str_contains() es más claro. Usa strpos() cuando importe la posición.

Sintaxis

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

La búsqueda distingue mayúsculas y minúsculas. $offset le dice dónde empezar a buscar; un desplazamiento negativo cuenta desde el final de la cadena.

La trampa de !== false

0 y false son iguales con la comparación flexible (==). Por eso cualquier comprobación que no sea estricta trata una coincidencia en la posición 0 como "no encontrado".

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

La misma regla se aplica a stripos(), strrpos() y array_search(), que pueden devolver 0 para una coincidencia real.

Búsqueda sin distinguir mayúsculas con stripos

stripos() acepta los mismos argumentos e ignora las mayúsculas y minúsculas de las letras 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

Encontrar la última aparición con strrpos

strrpos() devuelve la posición de la última coincidencia. Es la forma estándar de obtener la extensión de un archivo o el último segmento de una ruta.

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

Para nombres de archivo en concreto, pathinfo($file, PATHINFO_EXTENSION) lo hace por ti. Cortar la cadena en esa posición se explica en la página de substr().

Empezar la búsqueda en un desplazamiento

El tercer argumento se salta el principio de la cadena. Un desplazamiento negativo empieza esa cantidad de caracteres antes del final.

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

Encontrar todas las apariciones

strpos() encuentra una coincidencia. Recorre en un bucle y mueve el desplazamiento más allá de cada coincidencia para encontrarlas todas:

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

¿Solo el número? substr_count($text, 'the') es más corto. Para patrones, preg_match_all() con PREG_OFFSET_CAPTURE devuelve cada coincidencia con su posición.

Texto japonés: posición en bytes vs posición en caracteres

strpos() encuentra correctamente el texto multibyte, pero el número que devuelve está en bytes. Los kana y los kanji comunes ocupan 3 bytes cada uno en UTF-8, así que en un texto todo en japonés la posición en bytes es el triple de la posición en caracteres, y en un texto mixto las dos se separan de formas menos evidentes. mb_strpos() devuelve caracteres, que es lo que espera 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";

Mezclar las dos es un bug clásico: pasar un resultado de strpos() a mb_substr() empieza demasiado adentro de la cadena. Usa strpos con substr, y mb_strpos con mb_substr.