wp_normalize_path()
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.
1 time — 0.000001 sec (speed of light) | 50000 times — 0.05 sec (speed of light) | PHP 7.3.12, WP 5.3.2
No Hooks.
Return
String
. Normalized path.
Usage
wp_normalize_path( $path );
- $path(string) (required)
- Path to normalize.
Examples
#1 Make sure the path to the file is correct
Suppose we are developing a file path and we need to make sure there are no double slashes or backslashes in the path. To do this we pass the resulting path through wp_normalize_path():
echo wp_normalize_path( '\www\site.com\wp-content\/\uploads//file.jpg' ); // output: /www/site.com/wp-content/uploads/file.jpg echo wp_normalize_path( 'https://test.com//something/' ); // outputs: https://test.com/something/ echo wp_normalize_path( '//test.com//something/' ); // output: //test.com/something/
Changelog
Since 3.9.0 | Introduced. |
Since 4.4.0 | Ensures upper-case drive letters on Windows systems. |
Since 4.5.0 | Allows for Windows network shares. |
Since 4.9.7 | Allows for PHP file wrappers. |