Функция PATH_JOIN() в WordPress: описание, возврат и примеры

# Функция PATH_JOIN() в WordPress

## Описание

Функция path_join() служит для объединения двух путей файловой системы. Если второй параметр — это абсолютный путь (начинается со слэша /), будет возвращён только этот путь.

Функция работает следующим образом: вы передаёте $path, который относителен к $base, но если $path является абсолютным, просто возвращается он сам.

Функция автоматически добавляет слэш / между путями. 

### Время выполнения

- 1 раз — 0.000061 сек (очень быстро)  
- 50000 раз — 0.05 сек (очень быстро)  
- Доступно с PHP 7.1.1 и WP 4.7.2  

No Hooks.

## Возврат

Функция возвращает строку — путь, сформированный на основе базового пути или абсолютного пути.

## Использование

```php
path_join( $base, $path );

• $base (строка) (обязательный): базовый путь.
• $path (строка) (обязательный): путь, относительный к базовому.

Примеры

Пример 1: Объединение двух путей

echo path_join( '/var/example.com', '/wp_content/uploads' ); //> /wp_content/uploads
echo path_join( '/var/example.com', 'wp_content/uploads' );  //> /var/example.com/wp_content/uploads
echo path_join( '/var/example.com', '' );                    //> /var/example.com/
echo path_join( '/var/example.com', 'path' );               //> path
echo path_join( '/var/example.com', 'c:path' );            //> c:path

Пример 2: Подключение файла

Представим, что мы не знаем, является ли путь переменной $file абсолютным путем к файлу или просто его именем (относительным путем). В этом случае удобно использовать эту функцию:

$path = path_join( '/var/site/wp-content/', $file );
require_once( $path );

Теперь, независимо от того, что будет в переменной $file: file.php или /var/site/wp-content/file.php — в обоих случаях переменная $path будет равна /var/site/wp-content/file.php.

Код функции

Вот как выглядит реализация функции path_join():

function path_join( $base, $path ) {
if ( path_is_absolute( $path ) ) {
return $path;
}

return rtrim( $base, '/' ) . '/' . $path;

}

Заключение

Функция path_join() — полезный инструмент для работоспособной работы с файловыми путями в WordPress. Она помогает избежать ошибок, связанные с неправильным объединением путей.