# wp_register_plugin_realpath()

URL: https://chugunov.pro/api-wordpress/functions/wp_register_plugin_realpath/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.9.0.

## Сигнатура

```php
wp_register_plugin_realpath( string $file ): bool
```

## Описание

Используется в plugin_basename() для разрешения путей через символические ссылки.
См. alsowp_normalize_path()

## Параметры

- `$file` `string` — обязательный. Известный путь к файлу.

## Возвращаемое значение

`bool`

## Исходный код

Файл: `wp-includes/plugin.php:812`

```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;
}
```

## История изменений

- 3.9.0 — Introduced.

## Связанные

Использует: [`wp_normalize_path`](https://chugunov.pro/api-wordpress/functions/wp_normalize_path/).
Используется в: [`uninstall_plugin`](https://chugunov.pro/api-wordpress/functions/uninstall_plugin/), [`plugin_sandbox_scrape`](https://chugunov.pro/api-wordpress/functions/plugin_sandbox_scrape/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_register_plugin_realpath/