# wp_roles()

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

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

## Сигнатура

```php
wp_roles(): WP_Roles
```

## Описание

Получает глобальный экземпляр WP_Roles и создаёт его при необходимости.

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

`WP_Roles` — WP_Roles

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

Файл: `wp-includes/capabilities.php:1081`

```php
function wp_roles() {
	global $wp_roles;

	if ( ! isset( $wp_roles ) ) {
		$wp_roles = new WP_Roles();
	}
	return $wp_roles;
}
```

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

- 4.3.0 — Introduced.

## Связанные

Использует: `WP_Roles::__construct`.
Используется в: [`wp_switch_roles_and_user`](https://chugunov.pro/api-wordpress/functions/wp_switch_roles_and_user/), [`wp_get_users_with_no_role`](https://chugunov.pro/api-wordpress/functions/wp_get_users_with_no_role/), `WP_Users_List_Table::get_role_list`, [`populate_roles`](https://chugunov.pro/api-wordpress/functions/populate_roles/), [`edit_user`](https://chugunov.pro/api-wordpress/functions/edit_user/), [`get_editable_roles`](https://chugunov.pro/api-wordpress/functions/get_editable_roles/), `WP_Users_List_Table::get_views`, `WP_User::get_role_caps`, `WP_Role::add_cap`, `WP_Role::remove_cap`, [`get_role`](https://chugunov.pro/api-wordpress/functions/get_role/), [`add_role`](https://chugunov.pro/api-wordpress/functions/add_role/), [`remove_role`](https://chugunov.pro/api-wordpress/functions/remove_role/), [`count_users`](https://chugunov.pro/api-wordpress/functions/count_users/).

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