_prime_site_caches( array $ids, bool $update_meta_cache = true )

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness. Use update_site_cache() instead.

Adds any sites from the given IDs to the cache that do not already exist in cache.

Description

See also

Parameters

$ids

(array) (Required) ID list.

$update_meta_cache

(bool) (Optional) Whether to update the meta cache.

Default value: true

Source

File: wp-includes/ms-site.php 

function _prime_site_caches( $ids, $update_meta_cache = true ) {
	global $wpdb;

	$non_cached_ids = _get_non_cached_ids( $ids, 'sites' );
	if ( ! empty( $non_cached_ids ) ) {
		$fresh_sites = $wpdb->get_results( sprintf( "SELECT * FROM $wpdb->blogs WHERE blog_id IN (%s)", implode( ',', array_map( 'intval', $non_cached_ids ) ) ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared

		update_site_cache( $fresh_sites, $update_meta_cache );
	}
}

Uses

Uses Description
wp-includes/ms-site.php: update_site_cache()

Updates sites in cache.
wp-includes/functions.php: _get_non_cached_ids()

Retrieve IDs that are not already present in the cache.
wp-includes/wp-db.php: wpdb::get_results()

Retrieves an entire SQL result set from the database (i.e., many rows).

Used By

Used By Description
wp-includes/class-wp-site-query.php: WP_Site_Query::get_sites()

Retrieves a list of sites matching the query vars.

Changelog

Version Description
5.1.0 Introduced the $update_meta_cache parameter.
4.6.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/_prime_site_caches