Cos’è substr_count() in PHP

La funzione substr_count() di PHP serve per contare quante volte una sottostringa compare all’interno di una stringa principale. È utile quando bisogna verificare la presenza ripetuta di una parola, di un carattere o di una sequenza specifica dentro un testo.

Sintassi

substr_count(string $haystack, string $needle, int $offset = 0, ?int $length = null): int

Il parametro $haystack è la stringa in cui cercare, mentre $needle è la porzione di testo da contare. La funzione restituisce sempre un numero intero.

Esempio semplice

<?php
$testo = 'PHP è utile. PHP è veloce. PHP è flessibile.';

echo substr_count($testo, 'PHP');
// Output: 3
?>

In questo esempio la parola PHP compare tre volte, quindi la funzione restituisce 3.

Attenzione alle maiuscole e minuscole

substr_count() è case sensitive: questo significa che distingue tra lettere maiuscole e minuscole. Cercare php non è uguale a cercare PHP.

<?php
$testo = 'PHP php Php';

echo substr_count($testo, 'PHP');
// Output: 1
?>

Usare offset e length

La funzione permette anche di indicare da quale posizione iniziare la ricerca e per quanti caratteri analizzare la stringa.

<?php
$testo = 'Questo è un test';

echo substr_count($testo, 'e', 3);
?>

Il terzo parametro indica l’offset, cioè il punto da cui iniziare il conteggio.

Quando usare substr_count()

Questa funzione è utile per controllare quante volte compare una parola chiave in un testo, contare separatori in una stringa, analizzare piccoli contenuti testuali o verificare la presenza ripetuta di determinati caratteri.

Nota importante

Secondo la documentazione ufficiale PHP, substr_count() non conta le occorrenze sovrapposte e il confronto è sensibile alle maiuscole e minuscole.