count_users()

count_users() — Counts number of users who have each of the user roles. Assumes there are neither duplicated nor orphaned capabilities meta_values. Assumes role names are unique phrases. Same assumption made by WP_User_Query::prepare_query() Using $strategy = ‘time’ this is CPU-intensive and should handle around 10^7 users. Using $strategy = ‘memory’ this is memory-intensive and should handle around 10^5 users, but see WP Bug #12257.

Inputs: $strategy (string): Optional. The computational strategy to use when counting the users. Accepts either ‘time’ or ‘memory’. Default ‘time’. $site_id (int|null): Optional. The site ID to count users for. Defaults to the current site.

Returns array: User counts. Field $total_users (int): Total number of users on the site. Field $avail_roles (int[]): Array of user counts keyed by user role.