wp_register_plugin_realpath( string $file )
Register a plugin’s real path.
Description
This is used in plugin_basename() to resolve symlinked paths.
See also
Parameters
- $file
-
(Required) Known path to the file.
Return
(bool) Whether the path was able to be registered.
Source
File: wp-includes/plugin.php
function wp_register_plugin_realpath( $file ) {
global $wp_plugin_paths;
// Normalize, but store as static to avoid recalculation of a constant value
static $wp_plugin_path = null, $wpmu_plugin_path = null;
if ( ! isset( $wp_plugin_path ) ) {
$wp_plugin_path = wp_normalize_path( WP_PLUGIN_DIR );
$wpmu_plugin_path = wp_normalize_path( WPMU_PLUGIN_DIR );
}
$plugin_path = wp_normalize_path( dirname( $file ) );
$plugin_realpath = wp_normalize_path( dirname( realpath( $file ) ) );
if ( $plugin_path === $wp_plugin_path || $plugin_path === $wpmu_plugin_path ) {
return false;
}
if ( $plugin_path !== $plugin_realpath ) {
$wp_plugin_paths[ $plugin_path ] = $plugin_realpath;
}
return true;
}
Changelog
Version | Description |
---|---|
WP-3.9.0 | Introduced. |