path_join() WP 2.5.0

Объединяет (склеивает) два переданных системных пути. Если второй путь абсолютный (начинается со слэша), то просто вернет его.

Логика такая: дай мне $path относительно $base, но если $path абсолютный, то просто верни его...

При склейке добавляет слэш / между путями.

Хуков нет.

Возвращает

Строку. Склеенный или нет абсолютный путь.

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

path_join( $base, $path );

$base(string)

Базовый путь, который должен быть в начале $path.

$path(string)

Путь от $base.

Примеры

#1 Демонстрация склейки двух путей.

echo path_join('/var/site.ru', '/wp_content/uploads'); //> /wp_content/uploads
echo path_join('/var/site.ru', 'wp_content/uploads');  //> /var/site.ru/wp_content/uploads
echo path_join('/var/site.ru', '');                    //> /var/site.ru/
echo path_join('/var/site.ru', '\path');               //> \path
echo path_join('/var/site.ru', 'c:\\path');            //> c:\\path

#2 Подключим файл

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

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

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

Список изменений

Код path join: wp-includes/functions.php ^{WP 5.4.2}

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

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

Cвязанные функции

Из метки: path directory (путь папка)

Еще из раздела: Вспомогательные