PHP trim() : supprimer les espaces d'une chaîne

trim($string) renvoie la chaîne sans les espaces blancs au début et à la fin : espaces, tabulations, sauts de ligne, retours chariot, octets NUL et tabulations verticales. ltrim() ne les supprime qu'au début et rtrim() qu'à la fin. Les espaces au milieu sont gardés.

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

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

La sortie de var_dump() montre la longueur de chaque résultat, ce qui rend visibles les caractères supprimés. Appliquer trim est la première chose à faire avec la plupart des valeurs d'un formulaire (les mots de passe sont l'exception, voir la fin de la page) : un utilisateur qui tape ada@example.com avec un espace final doit quand même pouvoir se connecter.

Syntaxe

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() renvoie une nouvelle chaîne ; elle ne modifie pas la variable que vous passez.

Supprimer des caractères précis

Le second argument remplace la liste par défaut. Chaque caractère qu'il contient est supprimé aux extrémités, dans n'importe quel ordre et autant de fois que nécessaire. .. définit une plage, donc 'a..z' signifie toutes les lettres minuscules.

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

Pour continuer à supprimer aussi les espaces blancs normaux, incluez-les dans la liste : trim($s, " \n\r\t\v\0/").

Le second argument est un ensemble de caractères, pas une chaîne

trim() ne supprime pas un mot ou un suffixe. Elle supprime n'importe lequel des caractères listés, aux deux extrémités, jusqu'à en rencontrer un qui n'est pas dans la liste. Cela surprend ceux qui essaient de retirer une extension de fichier :

<?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 première ligne supprime aussi le h du début, car h fait partie de l'ensemble. Pour retirer un préfixe ou un suffixe fixe, utilisez str_starts_with() ou str_ends_with() avec substr(), ou str_replace() si le texte ne peut apparaître nulle part ailleurs.

Supprimer l'espace pleine chasse (saisie japonaise)

Les claviers japonais produisent souvent l'espace idéographique 　 (U+3000), par exemple autour d'un nom tapé dans un formulaire. Il ne fait pas partie de la liste par défaut de trim, et le mettre dans le second argument est un piège : trim() travaille octet par octet, l'espace correspond aux 3 octets E3 80 80, et E3 est aussi le premier octet de chaque hiragana et katakana, si bien qu'un nom qui commence par l'un d'eux perd le premier octet de ce caractère. Utilisez une expression régulière avec le modificateur 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 et \z ancrent au début et à la fin de la chaîne. Avec le modificateur u, \s correspond à tous les espaces Unicode : les espaces blancs ASCII, l'espace pleine chasse et l'espace insécable (U+00A0) qu'apporte souvent un copier-coller depuis une page web. Sans u, \s ne correspond qu'aux espaces blancs ASCII et l'espace pleine chasse reste. PHP 8.4 ajoute mb_trim(), mb_ltrim() et mb_rtrim() pour cela ; en PHP 8.3 et avant, l'expression régulière est la solution.

Appliquer trim à chaque valeur d'un tableau

array_map('trim', $array) nettoie chaque valeur et garde les clés. Un cas typique est une liste séparée par des virgules venant d'un champ texte, découpée avec 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));

Appliquer trim à une valeur de formulaire avant de la valider

Appliquez d'abord trim, puis vérifiez la chaîne vide. Un champ qui ne contient que des espaces est alors refusé comme vide. Exécutez ce bloc, tapez un nom entouré d'espaces dans le formulaire et cliquez sur Send : le même script s'exécute à nouveau avec $_POST rempli.

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

N'appliquez pas trim aux mots de passe : un espace à la fin d'un mot de passe en fait partie.