_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 ↗

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

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 6.9.7 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.