Функция untrailingslashit() удаляет завершающий слэш / или обратный слэш \ в конце переданной строки. Основное её назначение — обработка путей и URL, чтобы привести их к стандартному виду, особенно при работе с файловыми путями или ссылками.
untrailingslashit( $value ): stringПараметры
- $value
- (string, обязательный) Строка, из которой нужно удалить завершающие слэши.
Возвращаемое значение
Возвращает строку без завершающего слэша.
Пример 1: Удаление завершающего слэша из URL
Допустим, мы получили URL с ненужным завершающим слэшем и хотим его убрать, чтобы не допустить дублей ссылок.
$url = 'https://example.com/blog/';
echo untrailingslashit( $url );
// Вывод:
// https://example.com/blog
Пример 2: Обработка пути к файлу
При работе с путями файлов, иногда требуется, чтобы в конце пути не было лишнего слэша. untrailingslashit() поможет гарантировать, что путь будет записан корректно.
$file_path = '/var/www/mywebsite/uploads/';
echo untrailingslashit( $file_path );
// Вывод:
// /var/www/mywebsite/uploads
Пример 3: Проверка пустой строки или ложных значений
Функция untrailingslashit() корректно обрабатывает и возвращает пустую строку, если ей передано пустое значение, что может быть полезно в случаях, когда путь или URL отсутствуют.
var_dump( untrailingslashit('') ); // Вывод: string(0) ""
var_dump( untrailingslashit(false) ); // Вывод: string(0) ""
var_dump( untrailingslashit(null) ); // Вывод: string(0) ""
Пример 4: Удаление слэша из относительного пути
Относительные пути, такие как ../../, могут также содержать завершающий слэш. Функция untrailingslashit() удалит его, сохраняя корректность пути.
$relative_path = '../../';
echo untrailingslashit( $relative_path );
// Вывод:
// ../..
Особенности и полезные советы
- Использование с URL и путями: Несмотря на то, что функция чаще всего используется для путей, она также может применяться для URL и любых других строк, где требуется убрать завершающий слэш.
- Поддержка различных типов слэшей:
untrailingslashit()обрабатывает как обычные слэши/, так и обратные\, что полезно при работе с файловыми путями на разных операционных системах. - Быстрая работа: Функция выполняется очень быстро, что делает её полезной при частом использовании в циклах и обработке данных.
Заключение
Функция untrailingslashit() — это простой, но эффективный инструмент для обеспечения единообразия путей и URL, который предотвращает возможные ошибки из-за лишних завершающих слэшей.