wp_load_translations_early()

Description

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

Performance profile

How much work a call to wp_load_translations_early() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Heavy

Reads or writes the filesystem via is_dir().

Scaling

Scales with input

The body loops, so the work grows with how much data it finds.

Instructions

5–195

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 199.

Plugin surface

None

Nothing here hands control to plugin code.

Called by

16

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

What it touches

• filesystemfilesystem accessis_dir()called directly
• hookthird-party callbacksapply_filters()one call below wp_load_translations_early()

Further down the call graph this can also reach query, option, 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 · 33 distinct outcomes

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

Uses · 4

• did_action()Retrieves the number of times an action has been fired during the current request.
• load_textdomain()Loads a .mo file into the text domain $domain.
• WP_Textdomain_Registry::__construct()
• WP_Locale::__construct()Constructor which calls helper methods to set up object variables.

Used by · 16

• WP_Fatal_Error_Handler::display_default_error_template()Displays the default PHP error template.
• WP_Object_Cache::is_valid_key()Serves as a utility function to determine whether a key is valid.
• dead_db()Loads custom DB error or display WordPress DB error.
• is_blog_installed()Determines whether WordPress is already installed.
• ms_not_installed()Displays a failure message.
• wp_check_php_mysql_versions()Checks the server requirements.
• wp_maintenance()Dies with a maintenance message when conditions are met.
• wp_set_wpdb_vars()Sets the database table prefix and the format specifiers for database table columns.
• wpdb::_real_escape()Real escape using mysqli_real_escape_string().
• wpdb::check_connection()Checks that the connection to the database is still up. If not, try to reconnect.
• wpdb::db_connect()Connects to and selects database.
• wpdb::prepare()Prepares a SQL query for safe execution.

Source code

View on Trac ↗View on GitHub ↗

1524function wp_load_translations_early() {1525	global $wp_textdomain_registry, $wp_locale;1526	static $loaded = false;1527 1528	if ( $loaded ) {1529		return;1530	}1531 1532	$loaded = true;1533 1534	if ( function_exists( 'did_action' ) && did_action( 'init' ) ) {1535		return;1536	}1537 1538	// We need $wp_local_package.1539	require ABSPATH . WPINC . '/version.php';1540 1541	// Translation and localization.1542	require_once ABSPATH . WPINC . '/pomo/mo.php';1543	require_once ABSPATH . WPINC . '/l10n/class-wp-translation-controller.php';1544	require_once ABSPATH . WPINC . '/l10n/class-wp-translations.php';1545	require_once ABSPATH . WPINC . '/l10n/class-wp-translation-file.php';1546	require_once ABSPATH . WPINC . '/l10n/class-wp-translation-file-mo.php';1547	require_once ABSPATH . WPINC . '/l10n/class-wp-translation-file-php.php';1548	require_once ABSPATH . WPINC . '/l10n.php';1549	require_once ABSPATH . WPINC . '/class-wp-textdomain-registry.php';1550	require_once ABSPATH . WPINC . '/class-wp-locale.php';1551	require_once ABSPATH . WPINC . '/class-wp-locale-switcher.php';1552 1553	// General libraries.1554	require_once ABSPATH . WPINC . '/plugin.php';1555 1556	$locales   = array();1557	$locations = array();1558 1559	if ( ! $wp_textdomain_registry instanceof WP_Textdomain_Registry ) {1560		$wp_textdomain_registry = new WP_Textdomain_Registry();1561	}1562 1563	while ( true ) {1564		if ( defined( 'WPLANG' ) ) {1565			if ( '' === WPLANG ) {1566				break;1567			}1568			$locales[] = WPLANG;1569		}1570 1571		if ( isset( $wp_local_package ) ) {1572			$locales[] = $wp_local_package;1573		}1574 1575		if ( ! $locales ) {1576			break;1577		}1578 1579		if ( defined( 'WP_LANG_DIR' ) && @is_dir( WP_LANG_DIR ) ) {1580			$locations[] = WP_LANG_DIR;1581		}1582 1583		if ( defined( 'WP_CONTENT_DIR' ) && @is_dir( WP_CONTENT_DIR . '/languages' ) ) {1584			$locations[] = WP_CONTENT_DIR . '/languages';1585		}1586 1587		if ( @is_dir( ABSPATH . 'wp-content/languages' ) ) {1588			$locations[] = ABSPATH . 'wp-content/languages';1589		}1590 1591		if ( @is_dir( ABSPATH . WPINC . '/languages' ) ) {1592			$locations[] = ABSPATH . WPINC . '/languages';1593		}1594 1595		if ( ! $locations ) {1596			break;1597		}1598 1599		$locations = array_unique( $locations );1600 1601		foreach ( $locales as $locale ) {1602			foreach ( $locations as $location ) {1603				if ( file_exists( $location . '/' . $locale . '.mo' ) ) {

Changelog

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.0.4 tag, from src/wp-includes/load.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.