count_users()
Считает общее количество пользователей, разделяя их по ролям (администраторы, подписчики).
1 раз — 0.0375981 сек (тормоз) | 50000 раз — 1750.27 сек (тормоз) | PHP 7.3.12, WP 5.4
Хуки из функции
Возвращает
Массив. Данные о количестве пользователей. Массив такого вида:
Array( [total_users] => 2 [avail_roles] => Array( [administrator] => 1 [subscriber] => 1 ) )
Использование
$counts = count_users( $strategy );
- $strategy(строка)
- Может быть:
timeилиmemory.
По умолчанию: 'time' - $site_id(число) (c версии 4.9)
- ID сайта, для мультисайт режима.
По умолчанию: null
Примеры
#1 Что выводит функция
print_r( count_users() ); /* Array ( [total_users] => 474 [avail_roles] => Array ( [administrator] => 1 [subscriber] => 473 [none] => 0 ) ) */
#2 Пример, вывода записи о количестве пользователей в разрезе их ролей:
$result = count_users();
$roles = [];
foreach( $result['avail_roles'] as $role => $count ){
$roles[] = "{$role} ({$count})";
}
echo sprintf( 'На сайте пользователей - %s, среди которых: %s.',
$result['total_users'], implode( ', ', $roles )
);
В результате мы получит такую надпись:
На сайте пользователей - 2, среди которых: administrator (1), subscriber (1).
Заметки
- Global. wpdb.
$wpdbWordPress database abstraction object.
Список изменений
| С версии 3.0.0 | Введена. |
| С версии 4.4.0 | The number of users with no role is now included in the none element. |
| С версии 4.9.0 | The $site_id parameter was added to support multisite. |