Question

wp_normalize_path( string $path )

Normalize a filesystem path.

---

description

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.

---

参数

$path

(string) (Required) Path to normalize.

---

返回值

(string) Normalized path.

---

源代码

File: wp-includes/functions.php

function wp_normalize_path( $path ) {
	$path = str_replace( '\\', '/', $path );
	$path = preg_replace( '|(?<=.)/+|', '/', $path );
	if ( ':' === substr( $path, 1, 1 ) ) {
		$path = ucfirst( $path );
	}
	return $path;
}

---

更新日志

Version	description
4.5.0	Allows for Windows network shares.
4.4.0	Ensures upper-case drive letters on Windows systems.
3.9.0	Introduced.

---

相关函数

Used By

• wp-includes/link-template.php: plugins_url()
• wp-includes/plugin.php: plugin_basename()
• wp-includes/plugin.php: wp_register_plugin_realpath()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Example

   A Simple example to normalize the theme include path

   
       $bS_incl_path = get_template_directory() . '/inc';
   
       /**
        * Define theme include path
        * 
        * Normalize the include path to be safe on windows hosts
        * @return string Normalized path
        * require min WordPress version 3.9
        * @since boot_Strap 1.0.1
        * 
        */
   
        if(function_exists('wp_normalize_path')){
            
           $bS_incl_path = wp_normalize_path($bS_incl_path);
        }
       
       define('THM_INC', $bS_incl_path);
   
       require_once (THM_INC. '/wp_bootstrap_navwalker.php');   
   

   print_r($bS_incl_path); shows

   Using this function:

   
   C:/xampp/htdocs/boot_strap/wp-content/themes/boot_Strap/inc
   

   Without this function:

   
   C:\xampp\htdocs\boot_strap/wp-content/themes/boot_Strap/inc
   

   On a Windows server.