Функция trailingslashit() добавляет завершающий слэш / в конец переданной строки, если его там ещё нет. Это полезно при работе с путями к файлам и URL, чтобы обеспечить единообразие структуры ссылок и путей. Если в конце строки уже есть один или несколько слэшей, функция сначала удаляет их, а затем добавляет один завершающий слэш, избегая дублирования символов.
trailingslashit( string $value ): stringПараметры
- $value
- (string, обязательный) Строка, к которой нужно добавить завершающий слэш.
Возвращаемое значение
Возвращает строку с добавленным в конец завершающим слэшем.
Пример 1: Добавление завершающего слэша к пути
Если у нас есть путь к директории, важно, чтобы в конце пути был один слэш, чтобы избежать ошибок в дальнейшем использовании.
$path = '/var/www/html/uploads';
echo trailingslashit( $path );
// Вывод:
// /var/www/html/uploads/
Пример 2: Удаление двойного слэша
Если строка уже содержит завершающий слэш или даже несколько, trailingslashit() удалит их и добавит один завершающий слэш. Это полезно, когда передается динамический путь.
$url = 'https://example.com/path//';
echo trailingslashit( $url );
// Вывод:
// https://example.com/path/
Пример 3: Использование trailingslashit() при подключении стилей
При подключении стилей или скриптов через wp_enqueue_style() или wp_enqueue_script() можно использовать trailingslashit() для гарантии правильного формирования пути к файлу.
wp_enqueue_style( 'theme-style', trailingslashit( get_template_directory_uri() ) . 'assets/css/style.css' );
// Строка будет сформирована как: https://example.com/wp-content/themes/your-theme/assets/css/style.css
Пример 4: Подключение PHP файла
При использовании require или include для подключения файлов также можно применить trailingslashit(), чтобы избежать ошибок при указании пути к файлу.
require trailingslashit( get_template_directory() ) . 'inc/theme-functions.php';
// Подключение файла произойдет по пути /wp-content/themes/your-theme/inc/theme-functions.php
Пример 5: Проверка работы с разными типами значений
Функция корректно работает с пустыми значениями, если ей передано пустое значение.
echo trailingslashit(''); // Вывод: '/'
echo trailingslashit('path'); // Вывод: 'path/'
Особенности и рекомендации
- Универсальность функции:
trailingslashit()предназначена в первую очередь для путей, но её можно использовать и для URL, и для любых других строк, где требуется наличие завершающего слэша. - Оптимизация и скорость: Функция выполняется быстро, что позволяет её использовать в повторяющихся операциях без значительного влияния на производительность.
- Сочетание с
untrailingslashit(): Для обеспечения единообразия можно использовать вместе с функциейuntrailingslashit(), которая удаляет завершающий слэш в строке. Например,trailingslashit( untrailingslashit( $string ) )гарантирует, что строка всегда будет с одним завершающим слэшем независимо от исходного формата.
Заключение
Функция trailingslashit() — это удобная функция для создания корректных путей и URL, что особенно полезно при разработке тем и плагинов в WordPress, когда важно избегать ошибок из-за лишних или отсутствующих символов слэша в конце строки.