PHP trim(): удалить пробелы в начале и конце строки

trim($string) возвращает строку без пробельных символов в начале и в конце: пробелов, табуляций, переносов строк, возвратов каретки, NUL-байтов и вертикальных табуляций. ltrim() удаляет их только в начале, а rtrim() только в конце. Пробелы в середине сохраняются.

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

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

Вывод var_dump() показывает длину каждого результата, и так удалённые символы становятся видны. Обрезка пробелов это первое, что нужно сделать с большинством значений из формы (исключение пароли, смотрите конец страницы): пользователь, который ввёл ada@example.com с пробелом в конце, всё равно должен суметь войти.

Синтаксис

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() возвращает новую строку и не меняет переданную переменную.

Удаление определённых символов

Второй аргумент заменяет стандартный список. Каждый символ из него удаляется с концов, в любом порядке и сколько угодно раз. .. задаёт диапазон, поэтому 'a..z' означает все строчные буквы.

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

Чтобы по-прежнему удалять и обычные пробельные символы, включите их в список: trim($s, " \n\r\t\v\0/").

Второй аргумент это набор символов, а не строка

trim() не удаляет слово или суффикс. Она удаляет любые из перечисленных символов с обоих концов, пока не встретит символ не из списка. Это удивляет тех, кто пытается убрать расширение файла:

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

Первая строка удаляет и h в начале, потому что h есть в наборе. Чтобы убрать фиксированный префикс или суффикс, используйте str_starts_with() или str_ends_with() вместе с substr() или str_replace(), если этот текст не может встретиться больше нигде.

Полноширинный пробел (японский ввод)

Японские клавиатуры часто вводят идеографический пробел 　 (U+3000), например вокруг имени в форме. Его нет в стандартном списке trim, а указывать его во втором аргументе опасно: trim() работает побайтно, этот пробел это 3 байта E3 80 80, а E3 это ещё и первый байт каждого символа хираганы и катаканы, поэтому имя, которое начинается с такого символа, теряет его первый байт. Используйте регулярное выражение с модификатором 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 и \z привязывают к началу и концу строки. С модификатором u \s совпадает с любым пробелом Unicode: пробельными символами ASCII, полноширинным пробелом и неразрывным пробелом (U+00A0), который часто приносит копирование с веб-страниц. Без u \s совпадает только с пробельными символами ASCII, и полноширинный пробел остаётся. В PHP 8.4 для этого появились mb_trim(), mb_ltrim() и mb_rtrim(); в PHP 8.3 и раньше выход это регулярное выражение.

Обрезка каждого значения массива

array_map('trim', $array) обрезает каждое значение и сохраняет ключи. Типичный случай это список через запятую из текстового поля, разбитый через 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));

Обрезка значения формы перед проверкой

Сначала обрежьте, потом проверьте на пустую строку. Тогда поле, где одни пробелы, отклоняется как пустое. Запустите этот блок, введите в форму имя с пробелами вокруг и нажмите Send: тот же скрипт выполнится снова с заполненным $_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; ?>

Не обрезайте пароли: пробел в конце пароля это часть пароля.