# set_user_role

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

Тип: хук-действие.
Появился в версии: 2.9.0.

## Сигнатура

```php
do_action( 'set_user_role', int $user_id, string $role, string[] $old_roles )
```

## Описание

Срабатывает после изменения роли пользователя.

## Параметры

- `$user_id` `int` — обязательный. Идентификатор пользователя.
- `$role` `string` — обязательный. Новая роль.
- `$old_roles` `string[]` — обязательный. Массив предыдущих ролей пользователя.

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

Файл: `wp-includes/class-wp-user.php:663`

```php
do_action( 'set_user_role', $this->ID, $role, $old_roles );
```

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

- 3.6.0 — Added $old_roles to include an array of the user’s previous roles.
- 2.9.0 — Introduced.

## Связанные

Используется в: `WP_User::set_role`.

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