PHP substr(): einen Teil eines Strings holen

substr($string, $offset, $length) liefert den Teil von $string, der an Position $offset beginnt (ab 0 gezählt) und $length Zeichen lang ist. substr('Hello world', 0, 5) liefert "Hello". Lass $length weg, um alles bis zum Ende zu bekommen.

<?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() zählt Bytes. Bei englischem Text ist das dasselbe wie Zeichen, aber nicht bei Japanisch, Chinesisch, Emoji oder Buchstaben mit Akzent oder Umlaut. Dafür verwendest du mb_substr(), unten gezeigt.

Syntax

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

• $offset ist, wo es beginnt. 0 ist das erste Zeichen. Ein negativer Wert zählt vom Ende.
• $length ist, wie viele Bytes genommen werden (in reinem ASCII-Text ist ein Byte ein Zeichen). Ein negativer Wert lässt so viele am Ende weg. null (oder weglassen) bedeutet „bis zum Ende“.

Negativer Offset und negative Länge: vom Ende her arbeiten

Ein negativer $offset beginnt am Ende des Strings zu zählen, also ist -1 das letzte Zeichen. Eine negative $length hört so viele Zeichen vor dem Ende auf.

<?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) ist der übliche Weg, das letzte Zeichen zu entfernen, zum Beispiel ein Komma am Ende, das eine Schleife hinterlassen hat.

Das erste oder letzte Zeichen holen

Für ein einzelnes Byte kannst du den String auch direkt indizieren. $s[0] ist das erste Zeichen und seit PHP 7.1 ist $s[-1] das letzte.

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

Eine Position zu indizieren, die nicht existiert, gibt eine Warnung aus, während substr() einfach einen leeren String liefert. Wenn der String leer sein könnte, nimm lieber substr().

Außerhalb des Bereichs: ein leerer String, nicht false

Liegt $offset hinter dem Ende des Strings, liefert substr() in PHP 8 "". In PHP 7 lieferte es false, also funktioniert alter Code, der auf === false prüft, nicht mehr.

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

Japanischer Text: mb_substr verwenden

UTF-8 speichert Kana und gängige Kanji in je 3 Bytes (seltene Kanji wie 𠮷 und Emoji brauchen 4). substr() zählt Bytes, also liefert substr('こんにちは', 0, 3) nur こ, und eine Länge, die nicht auf einer Zeichengrenze endet, schneidet ein Zeichen in der Mitte durch und erzeugt kaputten Text. mb_substr() nimmt dieselben Argumente und zählt Zeichen.

<?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'));

Dasselbe gilt für Emoji und Buchstaben mit Akzent wie é. Zeichen zählt man mit mb_strlen(); siehe strlen() zu Bytes und Zeichen.

Text mit Auslassungspunkten kürzen

Einen langen Titel für eine Liste oder Karte zu kürzen ist der häufigste echte Einsatz von substr(). Verwende mb_substr(), damit ein japanischer Titel nie mitten im Zeichen abgeschnitten wird, und füge ... nur hinzu, wenn du tatsächlich gekürzt hast.

<?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, '...') macht dasselbe nach Anzeigebreite, wobei ein vollbreites japanisches Zeichen als 2 Spalten und ein lateinischer Buchstabe als 1 zählt. Das passt zu Layouts mit fester Breite.

Einen Teilstring mit substr_count zählen

substr_count($haystack, $needle) liefert, wie oft $needle vorkommt. Es unterscheidet Groß- und Kleinschreibung und zählt keine überlappenden Treffer.

<?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 mit strpos: Text vor oder nach einem Zeichen

Kombiniere substr() mit strpos(), um an einem Zeichen zu schneiden, dessen Position du vorher nicht kennst, etwa dem @ in einer E-Mail-Adresse:

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

Prüfe, dass strpos() nicht false geliefert hat, bevor du das Ergebnis verwendest: Fehlt das Zeichen, wird false ohne Warnung als 0 behandelt, also liefert substr('nobody', 0, $at) den Wert "" und substr('nobody', $at + 1) den Wert "obody".