mitmario.dev

Mit Text arbeiten

PHP Sandbox 3 Min Lesezeit 4 BeispieleLektion 5 von 7

Text kommt selten so an, wie du ihn brauchst. Da hängen Leerzeichen dran, die Groß- und Kleinschreibung passt nicht, und eine Zeile enthält drei Angaben auf einmal. Für jede dieser Sorgen hat PHP eine eigene Funktion.

Der Text geht dabei immer als Argument hinein, also strlen($text). Die Reihenfolge der Argumente ist allerdings nicht einheitlich. Bei str_contains kommt erst der Heuhaufen und dann die Nadel, bei str_replace erst das Gesuchte und dann der Text. Das ist historisch gewachsen und lässt sich nicht wegdiskutieren. Im PHP-Handbuch steht die Reihenfolge bei jeder Funktion gleich oben, und Nachschlagen geht schneller als Raten.

Messen und säubern

Messen und säubern
<?php

$eingabe = "   Mia Berger  ";

echo "Roh:      [", $eingabe, "]\n";
echo "Getrimmt: [", trim($eingabe), "]\n";
echo "Länge roh:       ", strlen($eingabe), "\n";
echo "Länge getrimmt:  ", strlen(trim($eingabe)), "\n";

$stadt = "Köln";
echo "Köln in Bytes:   ", strlen($stadt), "\n";
echo "Köln in Zeichen: ", mb_strlen($stadt), "\n";

trim entfernt Leerzeichen, Tabulatoren und Zeilenumbrüche am Anfang und am Ende. Das braucht praktisch jede Eingabe, die von außen kommt, denn irgendwer hat immer ein Leerzeichen hinter seinen Namen getippt. Für nur eine Seite gibt es ltrim und rtrim.

strlen sagt die Länge. Die eckigen Klammern in der Ausgabe stehen im Beispiel nur da, damit du siehst, wo der Text anfängt und aufhört. Das ist ein alter Trick bei der Fehlersuche.

Köln hat vier Zeichen und fünf Bytes, denn das ö braucht zwei, so wie das ü in Lektion 2.2 und in der Tabelle der letzten Lektion. mb_strlen zählt die vier Zeichen.

Suchen, ersetzen, herausschneiden

Suchen, ersetzen, herausschneiden
<?php

$titel = "Kaffee aus Kolumbien";

var_dump(str_contains($titel, "Kolumbien"));
var_dump(str_starts_with($titel, "Kaffee"));
echo str_replace("Kolumbien", "Brasilien", $titel), "\n";
echo substr($titel, 0, 6), "\n";
echo mb_substr("Köln am Rhein", 0, 4), "\n";
echo substr("Köln am Rhein", 0, 4), "\n";

str_contains beantwortet die Frage „kommt das darin vor“ mit true oder false. Dazu gibt es str_starts_with und str_ends_with für Anfang und Ende. Alle drei kamen erst mit PHP 8, und jede davon erspart dir eine umständliche Zeile.

str_replace tauscht aus, und zwar jedes Vorkommen, nicht nur das erste. Meistens will man das auch. Einmal im Jahr ist es eine böse Überraschung.

substr schneidet einen Ausschnitt heraus, ab einer Stelle und so viele, wie man angibt. Und hier lauert wieder die Byte-Zählung. Die letzten beiden Zeilen im Beispiel holen jeweils die ersten vier Einheiten aus Köln am Rhein. substr liefert Köl, weil das ö schon zwei der vier Bytes verbraucht hat, und mb_substr liefert Köln. Bei einer ungünstigeren Stelle bekommst du ein halbes Zeichen, und in der Ausgabe steht ein Fragezeichen in einer Raute.

Groß und klein

Groß und klein, und wo es schiefgeht
<?php

$name = "Straße";

echo strtoupper($name), "\n";
echo mb_strtoupper($name), "\n";
echo strtolower("KÖLN"), "\n";
echo mb_strtolower("KÖLN"), "\n";

strtolower und strtoupper sind der Klassiker, um zwei Eingaben vergleichbar zu machen. Bei deutschen Wörtern geht das aber sichtbar schief. Straße wird zu STRAßE, weil strtoupper das ß nicht kennt, und KÖLN wird zu kÖln, weil das Ö unberührt bleibt.

mb_strtoupper macht aus dem ß ein SS, mb_strtolower aus dem Ö ein ö. Wo in einer Anmeldung E-Mail-Adressen kleingeschrieben oder zwei Namen verglichen werden, gehört deshalb die mb_-Fassung hin. Sonst gelten Köln und KÖLN als zwei verschiedene Städte.

Zerlegen und zusammensetzen

Zerlegen und wieder zusammensetzen
<?php

$zeile = "Milch;1;1.20";
$teile = explode(";", $zeile);

echo "Erster Teil:  ", $teile[0], "\n";
echo "Zweiter Teil: ", $teile[1], "\n";
echo "Dritter Teil: ", $teile[2], "\n";

echo implode(" | ", $teile), "\n";

explode zerschneidet einen Text an einem Trennzeichen, implode klebt die Teile wieder zusammen. Die beiden sind ein Paar. Du findest sie in einer CSV-Zeile genauso wie bei einer Liste von Schlagworten, einem Pfad oder einer Adresse.

Was explode zurückgibt, ist eine Liste. An die einzelnen Teile kommst du über ihre Nummer in eckigen Klammern, und gezählt wird ab null. Listen sind das Thema von Abschnitt 5. Hier reicht dieser eine Handgriff, mehr braucht es für die Aufgabe nicht.

Hat der Text weniger Teile als erwartet, gibt es die höheren Nummern nicht, und der Zugriff darauf ist eine Warnung. Bei einer Zeile mit nur zwei Teilen steht für $teile[2] im Terminal PHP Warning: Undefined array key 2.

In der Aufgabe kommt eine Zeile mit drei Angaben und überflüssigen Leerzeichen.

Zum Mitnehmen

PHP hat für Text ein paar Dutzend Funktionen, und die Reihenfolge ihrer Argumente ist uneinheitlich. trim, explode und implode braucht man ständig, und wo ein Mensch das Ergebnis liest, zählt nur die mb_-Fassung Zeichen statt Bytes.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 4 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.