PHP substr(): estrarre una parte di una stringa

substr($string, $offset, $length) restituisce la parte di $string che inizia alla posizione $offset (contata da 0) ed è lunga $length caratteri. substr('Hello world', 0, 5) restituisce "Hello". Ometti $length per ottenere tutto fino alla fine.

<?php
$s = 'Hello world';

echo substr($s, 0, 5), "\n";   // from the start, 5 characters
echo substr($s, 6), "\n";      // from position 6 to the end
echo substr($s, 4, 3), "\n";   // 3 characters from position 4

substr() conta i byte. Per il testo inglese è lo stesso che contare i caratteri, ma non per giapponese, cinese, emoji o lettere accentate. Per quelli usa mb_substr(), mostrata più avanti.

Sintassi

substr(string $string, int $offset, ?int $length = null): string

• $offset è il punto da cui partire. 0 è il primo carattere. Un valore negativo conta dalla fine.
• $length è quanti byte prendere (in un semplice testo ASCII un byte è un carattere). Un valore negativo ne lascia fuori quel numero alla fine. null (o ometterlo) significa "fino alla fine".

Offset e lunghezza negativi: lavorare dalla fine

Un $offset negativo inizia a contare dalla fine della stringa, quindi -1 è l'ultimo carattere. Una $length negativa si ferma quel numero di caratteri prima della fine.

<?php
$file = 'report-2026.pdf';

echo substr($file, -3), "\n";       // last 3 characters
echo substr($file, -8, 4), "\n";    // 4 characters, starting 8 from the end
echo substr($file, 0, -4), "\n";    // everything except the last 4
echo substr($file, 7, -4), "\n";    // from position 7, minus the last 4

substr($s, 0, -1) è il modo abituale per rimuovere l'ultimo carattere, per esempio una virgola finale lasciata da un ciclo.

Ottenere il primo o l'ultimo carattere

Per un singolo byte puoi anche indicizzare direttamente la stringa. $s[0] è il primo carattere e, da PHP 7.1, $s[-1] è l'ultimo.

<?php
$word = 'banana';

echo substr($word, 0, 1), ' ', $word[0], "\n";    // first character
echo substr($word, -1), ' ', $word[-1], "\n";     // last character
echo substr($word, 1), "\n";                     // drop the first character

Indicizzare una posizione che non esiste stampa un warning, mentre substr() restituisce semplicemente una stringa vuota. Se la stringa potrebbe essere vuota, preferisci substr().

Fuori intervallo: una stringa vuota, non false

Se $offset è oltre la fine della stringa, substr() restituisce "" in PHP 8. In PHP 7 restituiva false, quindi il vecchio codice che controlla === false non funziona più.

<?php
var_dump(substr('abc', 5));       // start past the end
var_dump(substr('abc', 1, 100));  // length longer than the rest is fine
var_dump(substr('abc', -10));     // negative offset before the start: from 0

Testo giapponese: usa mb_substr

UTF-8 memorizza i kana e i kanji comuni in 3 byte ciascuno (i kanji rari come 𠮷 e le emoji ne occupano 4). substr() conta i byte, quindi substr('こんにちは', 0, 3) restituisce solo こ, e una lunghezza che non cade al confine di un carattere taglia a metà un carattere e produce testo rotto. mb_substr() accetta gli stessi argomenti e conta i caratteri.

<?php
$greeting = 'こんにちは世界';

echo substr($greeting, 0, 3), "\n";       // 3 bytes = 1 character
echo mb_substr($greeting, 0, 3), "\n";    // 3 characters
echo mb_substr($greeting, -2), "\n";      // last 2 characters

// Cutting at 4 bytes splits a character: the result is not valid UTF-8
var_dump(mb_check_encoding(substr($greeting, 0, 4), 'UTF-8'));

Lo stesso vale per le emoji e le lettere accentate come é. Per contare i caratteri si usa mb_strlen(); vedi strlen() per byte e caratteri.

Accorciare un testo con i puntini di sospensione

Tagliare un titolo lungo per una lista o una scheda è l'uso reale più comune di substr(). Usa mb_substr() così un titolo giapponese non viene mai tagliato a metà carattere, e aggiungi ... solo quando hai davvero accorciato qualcosa.

<?php
function excerpt(string $text, int $max): string
{
    if (mb_strlen($text) <= $max) {
        return $text;
    }
    return rtrim(mb_substr($text, 0, $max)) . '...';
}

echo excerpt('Short title', 20), "\n";
echo excerpt('A much longer title that will not fit in the card', 20), "\n";
echo excerpt('東京から大阪までの新幹線の旅', 8), "\n";

mb_strimwidth($text, 0, $width, '...') fa lo stesso in base alla larghezza di visualizzazione, dove un carattere giapponese a larghezza piena conta 2 colonne e una lettera latina 1. È adatta ai layout a larghezza fissa.

Contare una sottostringa con substr_count

substr_count($haystack, $needle) restituisce quante volte compare $needle. Distingue maiuscole e minuscole e non conta le corrispondenze sovrapposte.

<?php
echo substr_count('banana', 'an'), "\n";
echo substr_count('aaaa', 'aa'), "\n";      // 2, not 3: no overlaps
echo substr_count('Hello hello', 'hello'), "\n";
echo substr_count(strtolower('Hello hello'), 'hello'), "\n";

substr con strpos: testo prima o dopo un carattere

Combina substr() con strpos() per tagliare a un carattere di cui non conosci in anticipo la posizione, come la @ in un indirizzo email:

<?php
$email = 'ada.lovelace@example.com';
$at = strpos($email, '@');

echo substr($email, 0, $at), "\n";    // before the @
echo substr($email, $at + 1), "\n";   // after the @

// strstr does the same in one call
echo strstr($email, '@', true), "\n";

Verifica che strpos() non abbia restituito false prima di usarne il risultato: se il carattere manca, false viene trattato come 0 senza alcun warning, quindi substr('nobody', 0, $at) restituisce "" e substr('nobody', $at + 1) restituisce "obody".