_get_random_header_data(): object

Return

object

Cost profile

Measured from the compiled opcodes, not from a stopwatch. Every number here is identical on any machine that runs the same PHP version, and every function in core is ranked by these figures.

Cost class

Heavy

Reaches the database via get_posts().

Scaling

Constant

No loop in the body: the same number of instructions runs whatever you pass in.

Instructions

5–55

Executed per call on PHP 8.4, depending on the branch taken. The body compiles to 64.

Plugin surface

None

Nothing here hands control to plugin code.

Called by

2

2 places in core call this, so the cost is paid more often than your own code shows.

What it touches

• hookthird-party callbacksapply_filters()one call below _get_random_header_data()
• querycontent queryget_posts()one call below _get_random_header_data()
• optionoption read or writeget_option()one call below _get_random_header_data()

Further down the call graph this can also reach cache, serialize and transient — those are the worst case, several calls deep and usually down an error path, not what a normal call pays.

What one call costs · 7 distinct outcomes

One number would be a lie: the work depends on which branch runs. These are every distinct cost _get_random_header_data() can have, taken from its control-flow graph on PHP 8.4.

Across PHP versions

Oldest PHP that compiles this body: 7.4. An instruction is not a fixed amount of time, so a version with the same count is not necessarily the same speed; what the count rules out is a difference in the work itself.

Uses · 6

• get_theme_mod()Retrieves theme modification value for the active theme.
• get_uploaded_header_images()Gets the header images uploaded for the active theme.
• current_theme_supports()Checks a theme's support for a given feature.
• get_template_directory_uri()Retrieves template directory URI for the active theme.
• get_stylesheet_directory_uri()Retrieves stylesheet directory URI for the active theme.
• stdClass::__construct()

Used by · 2

• get_custom_header()Gets the header image data.
• get_random_header_image()Gets random header image URL from registered images in theme.

Source

View on Trac ↗View on GitHub ↗

1395function _get_random_header_data() {1396	global $_wp_default_headers;1397	static $_wp_random_header = null;1398 1399	if ( empty( $_wp_random_header ) ) {1400		$header_image_mod = get_theme_mod( 'header_image', '' );1401		$headers          = array();1402 1403		if ( 'random-uploaded-image' === $header_image_mod ) {1404			$headers = get_uploaded_header_images();1405		} elseif ( ! empty( $_wp_default_headers ) ) {1406			if ( 'random-default-image' === $header_image_mod ) {1407				$headers = $_wp_default_headers;1408			} else {1409				if ( current_theme_supports( 'custom-header', 'random-default' ) ) {1410					$headers = $_wp_default_headers;1411				}1412			}1413		}1414 1415		if ( empty( $headers ) ) {1416			return new stdClass();1417		}1418 1419		$_wp_random_header = (object) $headers[ array_rand( $headers ) ];1420 1421		$_wp_random_header->url = sprintf(1422			$_wp_random_header->url,1423			get_template_directory_uri(),1424			get_stylesheet_directory_uri()1425		);1426 1427		$_wp_random_header->thumbnail_url = sprintf(1428			$_wp_random_header->thumbnail_url,1429			get_template_directory_uri(),1430			get_stylesheet_directory_uri()1431		);1432	}1433 1434	return $_wp_random_header;1435}

History

Introduced in 3.4.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/theme.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.