wp_normalize_path() │ WP 3.9.0

Заменяет обратные слэши на прямые слэши и двойные слэши на одинарные.

Работает на основе: wp_is_stream()
1 раз — 0.000001 сек (скорость света) | 50000 раз — 0.05 сек (скорость света) | PHP 7.3.12, WP 5.3.2

Хуков нет.

Возвращает

Строку. Очищенную (обработанную) строку.

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

wp_normalize_path( $path );
$path(строка) (обязательный)
Путь, который нужно обработать.

Примеры

0

#1 Убедимся что путь до файла правильный

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

echo wp_normalize_path( '\www\example.com\wp-content\/\uploads//file.jpg' );
					//>> /www/example.com/wp-content/uploads/file.jpg

echo wp_normalize_path( 'https://test.com//something/' ); 
					//>> https://test.com/something/

echo wp_normalize_path( '//test.com//something/' ); 
					//>> //test.com/something/

echo wp_normalize_path( 'c://some\/\path//file.jpg' ); 
					//>> C:/some/path/file.jpg

echo wp_normalize_path( 'c:/Projects\\api/\apilibrary.sln' ); 
					//>> C:/Projects/api/apilibrary.sln

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

С версии 3.9.0 Введена.
С версии 4.4.0 Ensures upper-case drive letters on Windows systems.
С версии 4.5.0 Allows for Windows network shares.
С версии 4.9.7 Allows for PHP file wrappers.

Код wp_normalize_path() WP 6.7.2

wp-includes/functions.php 
function wp_normalize_path( $path ) {
	$wrapper = '';

	if ( wp_is_stream( $path ) ) {
		list( $wrapper, $path ) = explode( '://', $path, 2 );

		$wrapper .= '://';
	}

	// Standardize all paths to use '/'.
	$path = str_replace( '\\', '/', $path );

	// Replace multiple slashes down to a singular, allowing for network shares having two slashes.
	$path = preg_replace( '|(?<=.)/+|', '/', $path );

	// Windows paths should uppercase the drive letter.
	if ( ':' === substr( $path, 1, 1 ) ) {
		$path = ucfirst( $path );
	}

	return $wrapper . $path;
}

path directory (путь папка)

Вспомогательные