PHP trim(): rimuovere gli spazi da una stringa

trim($string) restituisce la stringa senza gli spazi bianchi all'inizio e alla fine: spazi, tabulazioni, a capo, ritorni a capo, byte NUL e tabulazioni verticali. ltrim() li rimuove solo dall'inizio e rtrim() solo dalla fine. Gli spazi in mezzo restano.

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

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

L'output di var_dump() mostra la lunghezza di ogni risultato, il che rende visibili i caratteri rimossi. Il trim è la prima cosa da fare con la maggior parte dei valori di un form (le password sono l'eccezione, vedi la fine della pagina): un utente che scrive ada@example.com con uno spazio finale deve comunque poter accedere.

Sintassi

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() restituisce una nuova stringa; non modifica la variabile che passi.

Rimuovere caratteri specifici

Il secondo argomento sostituisce la lista di default. Ogni carattere al suo interno viene rimosso dalle estremità, in qualsiasi ordine e qualsiasi numero di volte. .. definisce un intervallo, quindi 'a..z' significa ogni lettera minuscola.

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

Per continuare a rimuovere anche gli spazi bianchi normali, includili nella lista: trim($s, " \n\r\t\v\0/").

Il secondo argomento è un insieme di caratteri, non una stringa

trim() non rimuove una parola o un suffisso. Rimuove uno qualsiasi dei caratteri che elenchi, da entrambe le estremità, finché non incontra un carattere che non è nella lista. Questo sorprende chi prova a togliere l'estensione di un file:

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

La prima riga rimuove anche la h iniziale, perché h è nell'insieme. Per rimuovere un prefisso o un suffisso fisso, usa str_starts_with() o str_ends_with() con substr(), oppure str_replace() se il testo non può comparire altrove.

Rimuovere lo spazio a larghezza piena (input giapponese)

Le tastiere giapponesi producono spesso lo spazio ideografico 　 (U+3000), per esempio intorno a un nome scritto in un form. Non è nella lista di default di trim, e indicarlo nel secondo argomento è una trappola: trim() lavora byte per byte, lo spazio è formato dai 3 byte E3 80 80, ed E3 è anche il primo byte di ogni carattere hiragana e katakana, quindi un nome che inizia con uno di essi perde il primo byte di quel carattere. Usa un'espressione regolare con il modificatore 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 e \z ancorano all'inizio e alla fine della stringa. Con il modificatore u, \s corrisponde a ogni spazio Unicode: gli spazi bianchi ASCII, lo spazio a larghezza piena e lo spazio non separabile (U+00A0) che il copia e incolla dalle pagine web porta spesso con sé. Senza u, \s corrisponde solo agli spazi bianchi ASCII e lo spazio a larghezza piena resta. PHP 8.4 aggiunge mb_trim(), mb_ltrim() e mb_rtrim() per questo; su PHP 8.3 e precedenti la strada è l'espressione regolare.

Fare il trim di ogni valore di un array

array_map('trim', $array) ripulisce ogni valore e mantiene le chiavi. Un caso tipico è una lista separata da virgole presa da un campo di testo, divisa con 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));

Fare il trim di un valore di un form prima di validarlo

Prima il trim, poi il controllo della stringa vuota. Un campo che contiene solo spazi viene così rifiutato come vuoto. Esegui questo blocco, scrivi nel form un nome con degli spazi intorno e premi Send: lo stesso script viene eseguito di nuovo con $_POST compilato.

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

Non fare il trim delle password: uno spazio alla fine di una password ne fa parte.