PHP trim(): Leerzeichen aus einem String entfernen

trim($string) liefert den String ohne Leerraum am Anfang und am Ende: Leerzeichen, Tabs, Zeilenumbrüche, Wagenrückläufe, NUL-Bytes und vertikale Tabs. ltrim() entfernt ihn nur am Anfang und rtrim() nur am Ende. Leerzeichen in der Mitte bleiben erhalten.

<?php
$input = "   Ada Lovelace \n";

var_dump(trim($input));
var_dump(ltrim($input));
var_dump(rtrim($input));

Die Ausgabe von var_dump() zeigt die Länge jedes Ergebnisses und macht damit die entfernten Zeichen sichtbar. Trimmen ist das Erste, was du mit den meisten Werten aus einem Formular tust (Passwörter sind die Ausnahme, siehe Ende der Seite): Wer ada@example.com mit einem Leerzeichen am Ende tippt, soll sich trotzdem anmelden können.

Syntax

trim(string $string, string $characters = " \n\r\t\v\0"): string
ltrim(string $string, string $characters = " \n\r\t\v\0"): string
rtrim(string $string, string $characters = " \n\r\t\v\0"): string

trim() liefert einen neuen String; es ändert die übergebene Variable nicht.

Bestimmte Zeichen trimmen

Das zweite Argument ersetzt die Standardliste. Jedes Zeichen darin wird an den Enden entfernt, in beliebiger Reihenfolge und beliebig oft. .. definiert einen Bereich, also bedeutet 'a..z' jeden Kleinbuchstaben.

<?php
echo trim('***Sale***', '*'), "\n";
echo rtrim('red, green, blue, ', ', '), "\n";   // remove the trailing ", "
echo ltrim('000123', '0'), "\n";                // leading zeros
echo trim('/blog/post/', '/'), "\n";
echo trim('abc123xyz', 'a..z'), "\n";           // every lowercase letter

Um weiterhin auch normalen Leerraum zu entfernen, nimmst du ihn in die Liste auf: trim($s, " \n\r\t\v\0/").

Das zweite Argument ist eine Menge von Zeichen, kein String

trim() entfernt kein Wort und keine Endung. Es entfernt beliebige der aufgeführten Zeichen an beiden Enden, bis es auf eines trifft, das nicht in der Liste steht. Das überrascht alle, die eine Dateiendung abschneiden wollen:

<?php
// Looks like "remove .php", but removes the characters . p h from both ends
var_dump(trim('hello.php', '.php'));

// Remove a suffix: check it, then cut it off
$file = 'hello.php';
if (str_ends_with($file, '.php')) {
    $file = substr($file, 0, -strlen('.php'));
}
var_dump($file);

Die erste Zeile entfernt auch das h am Anfang, weil h in der Menge steht. Um ein festes Präfix oder Suffix zu entfernen, verwendest du str_starts_with() oder str_ends_with() mit substr() oder str_replace(), wenn der Text nirgendwo sonst vorkommen kann.

Das vollbreite Leerzeichen trimmen (japanische Eingabe)

Japanische Tastaturen erzeugen oft das ideografische Leerzeichen 　 (U+3000), zum Beispiel um einen Namen, der in ein Formular getippt wurde. Es steht nicht in der Standardliste von trim, und es im zweiten Argument aufzuführen ist eine Falle: trim() arbeitet Byte für Byte, das Leerzeichen besteht aus den 3 Bytes E3 80 80, und E3 ist auch das erste Byte jedes Hiragana- und Katakana-Zeichens, also verliert ein Name, der mit einem solchen Zeichen beginnt, dessen erstes Byte. Verwende einen regulären Ausdruck mit dem Modifikator u:

<?php
$name = '　さとう 花子　 ';

var_dump(trim($name));   // the full-width spaces stay

// Listing the space as a character breaks さ: the result is not valid UTF-8
var_dump(mb_check_encoding(trim($name, '　'), 'UTF-8'));

function mbTrim(string $s): string
{
    return preg_replace('/\A\s+|\s+\z/u', '', $s);
}

var_dump(mbTrim($name));

\A und \z verankern am Anfang und Ende des Strings. Mit dem Modifikator u trifft \s jedes Unicode-Leerzeichen: den ASCII-Leerraum, das vollbreite Leerzeichen und das geschützte Leerzeichen (U+00A0), das Kopieren und Einfügen von Webseiten oft mitbringt. Ohne u trifft \s nur ASCII-Leerraum, und das vollbreite Leerzeichen bleibt stehen. PHP 8.4 bringt dafür mb_trim(), mb_ltrim() und mb_rtrim(); unter PHP 8.3 und älter ist der reguläre Ausdruck der Weg.

Jeden Wert in einem Array trimmen

array_map('trim', $array) trimmt jeden Wert und behält die Schlüssel. Ein typischer Fall ist eine kommagetrennte Liste aus einem Textfeld, aufgeteilt mit explode():

<?php
$tags = explode(',', ' php , mysql,  laravel ,');

$tags = array_map('trim', $tags);
$tags = array_filter($tags, fn($t) => $t !== '');

print_r(array_values($tags));

// An associative array of form fields keeps its keys
$form = ['name' => '  Ada ', 'email' => " ada@example.com\n"];
print_r(array_map('trim', $form));

Einen Formularwert vor der Validierung trimmen

Erst trimmen, dann auf einen leeren String prüfen. Ein Feld, das nur Leerzeichen enthält, wird dann als leer abgelehnt. Führe diesen Block aus, tippe einen Namen mit Leerzeichen drumherum ins Formular und klicke auf Send: Dasselbe Skript läuft erneut, mit gefülltem $_POST.

<?php
$raw = $_POST['name'] ?? '';
$name = trim($raw);
$error = '';

if (($_SERVER['REQUEST_METHOD'] ?? 'GET') === 'POST' && $name === '') {
    $error = 'Please enter your name.';
}
?>
<form method="post">
  <input name="name" value="<?= htmlspecialchars($raw) ?>">
  <button>Send</button>
</form>
<?php if ($error !== ''): ?>
  <p style="color: #c00"><?= $error ?></p>
<?php elseif ($name !== ''): ?>
  <p>Sent "<?= htmlspecialchars($raw) ?>", saved "<?= htmlspecialchars($name) ?>" (<?= strlen($raw) ?> bytes became <?= strlen($name) ?>)</p>
<?php endif; ?>

Trimme keine Passwörter: Ein Leerzeichen am Ende eines Passworts gehört dazu.