_prime_site_caches() │ WP 4.6.0

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

Internal function — this function is designed to be used by the kernel itself. It is not recommended to use this function in your code.

No Hooks.

Return

null. Nothing (null).

Usage

_prime_site_caches( $ids, $update_meta_cache );

$ids(array) (required): ID list.
$update_meta_cache(true|false): Whether to update the meta cache.
Default: true

Notes

See: update_site_cache()
Global. wpdb. $wpdb WordPress database abstraction object.

Changelog

Since 4.6.0	Introduced.
Since 5.1.0	Introduced the `$update_meta_cache` parameter.
Since 6.1.0	This function is no longer marked as "private".
Since 6.3.0	Use wp_lazyload_site_meta() for lazy-loading of site meta.

`_prime_site_caches() prime site caches` code ^{WP 6.7.1}

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, false );
	}

	if ( $update_meta_cache ) {
		wp_lazyload_site_meta( $ids );
	}
}