Description

Normalize a filesystem path.

On windows systems, replaces backslashes with forward slashes and forces upper-case drive letters. Allows for two leading slashes for Windows network shares, but ensures that all other duplicate slashes are reduced to a single.

Usage

$string = wp_normalize_path( $path );

Parameters

$path

( string ) required – Path to normalize.

Returns

string Normalized path.

Source

File name: wordpress/wp-includes/functions.php
Lines:

function wp_normalize_path( $path ) {
  $wrapper = '';

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

    $wrapper .= '://';
  }

  // Standardise 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;
}
 

 View on GitHub View on Trac