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 Пример, вывода записи о количестве пользователей в разрезе их ролей:
$result = count_users(); echo 'На сайте пользователей - '. $result['total_users'] . ', среди которых: '; foreach( $result['avail_roles'] as $role => $count ){ echo ( ++$i > 1 ? ', ' : ' ' ) . $role .' - '. $count; } echo '.';
В результате мы получит такую надпись:
На сайте пользователей - 2, среди которых: administrator - 1, subscriber - 1.
#2 Что выводит функция
print_r( count_users() ); /* Array ( [total_users] => 474 [avail_roles] => Array ( [administrator] => 1 [subscriber] => 473 [none] => 0 ) ) */
Заметки
- Global. wpdb. $wpdb WordPress 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. |