wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_normalize_path › WordPress Function

Since3.9.0
Deprecatedn/a
› wp_normalize_path ( $path )
Parameters:
  • (string) $path Path to normalize.
    Required: Yes
Returns:
  • (string) Normalized path.
Defined at:
Codex:
Change Log:
  • 4.4.0
  • 4.5.0
  • 4.9.7
  • 7.0.0

Normalizes 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.


Related Functions: wp_normalize_site_data, wp_localize_script, normalize_whitespace, wp_get_original_image_path, wp_kses_normalize_entities

Source 

function wp_normalize_path( $path ): string {
	$path = (string) $path;

	static $cache = array();
	if ( isset( $cache[ $path ] ) ) {
		return $cache[ $path ];
	}

	$original_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 = (string) preg_replace( '|(?<=.)/+|', '/', $path );

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

	$cache[ $original_path ] = $wrapper . $path;
	return $cache[ $original_path ];
}