X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/fa11948979fd6a4ea5705dc613b239699a459db3..4feeb71a9d812a9ae371c28a3d8b442a4394ded7:/wp-includes/load.php?ds=sidebyside diff --git a/wp-includes/load.php b/wp-includes/load.php index e589f5fa..a6135be1 100644 --- a/wp-includes/load.php +++ b/wp-includes/load.php @@ -7,12 +7,26 @@ * @package WordPress */ +/** + * Return the HTTP protocol sent by the server. + * + * @since 4.4.0 + * + * @return string The HTTP protocol. Default: HTTP/1.0. + */ +function wp_get_server_protocol() { + $protocol = $_SERVER['SERVER_PROTOCOL']; + if ( ! in_array( $protocol, array( 'HTTP/1.1', 'HTTP/2', 'HTTP/2.0' ) ) ) { + $protocol = 'HTTP/1.0'; + } + return $protocol; +} + /** * Turn register globals off. * - * @access private * @since 2.1.0 - * @return null Will return null if register_globals PHP directive was disabled + * @access private */ function wp_unregister_GLOBALS() { if ( !ini_get( 'register_globals' ) ) @@ -32,10 +46,13 @@ function wp_unregister_GLOBALS() { } /** - * Fix $_SERVER variables for various setups. + * Fix `$_SERVER` variables for various setups. * - * @access private * @since 3.0.0 + * @access private + * + * @global string $PHP_SELF The filename of the currently executing script, + * relative to the document root. */ function wp_fix_server_vars() { global $PHP_SELF; @@ -48,14 +65,14 @@ function wp_fix_server_vars() { $_SERVER = array_merge( $default_server_values, $_SERVER ); // Fix for IIS when running with PHP ISAPI - if ( empty( $_SERVER['REQUEST_URI'] ) || ( php_sapi_name() != 'cgi-fcgi' && preg_match( '/^Microsoft-IIS\//', $_SERVER['SERVER_SOFTWARE'] ) ) ) { + if ( empty( $_SERVER['REQUEST_URI'] ) || ( PHP_SAPI != 'cgi-fcgi' && preg_match( '/^Microsoft-IIS\//', $_SERVER['SERVER_SOFTWARE'] ) ) ) { // IIS Mod-Rewrite if ( isset( $_SERVER['HTTP_X_ORIGINAL_URL'] ) ) { $_SERVER['REQUEST_URI'] = $_SERVER['HTTP_X_ORIGINAL_URL']; } // IIS Isapi_Rewrite - else if ( isset( $_SERVER['HTTP_X_REWRITE_URL'] ) ) { + elseif ( isset( $_SERVER['HTTP_X_REWRITE_URL'] ) ) { $_SERVER['REQUEST_URI'] = $_SERVER['HTTP_X_REWRITE_URL']; } else { // Use ORIG_PATH_INFO if there is no PATH_INFO @@ -92,29 +109,43 @@ function wp_fix_server_vars() { } /** - * Check for the required PHP version, and the MySQL extension or a database drop-in. + * Check for the required PHP version, and the MySQL extension or + * a database drop-in. * * Dies if requirements are not met. * - * @access private * @since 3.0.0 + * @access private + * + * @global string $required_php_version The required PHP version string. + * @global string $wp_version The WordPress version string. */ function wp_check_php_mysql_versions() { global $required_php_version, $wp_version; $php_version = phpversion(); + if ( version_compare( $required_php_version, $php_version, '>' ) ) { wp_load_translations_early(); + + $protocol = wp_get_server_protocol(); + header( sprintf( '%s 500 Internal Server Error', $protocol ), true, 500 ); + header( 'Content-Type: text/html; charset=utf-8' ); die( sprintf( __( 'Your server is running PHP version %1$s but WordPress %2$s requires at least %3$s.' ), $php_version, $wp_version, $required_php_version ) ); } - if ( ! extension_loaded( 'mysql' ) && ! file_exists( WP_CONTENT_DIR . '/db.php' ) ) { + if ( ! extension_loaded( 'mysql' ) && ! extension_loaded( 'mysqli' ) && ! extension_loaded( 'mysqlnd' ) && ! file_exists( WP_CONTENT_DIR . '/db.php' ) ) { wp_load_translations_early(); + + $protocol = wp_get_server_protocol(); + header( sprintf( '%s 500 Internal Server Error', $protocol ), true, 500 ); + header( 'Content-Type: text/html; charset=utf-8' ); die( __( 'Your PHP installation appears to be missing the MySQL extension which is required by WordPress.' ) ); } } /** * Don't load all of WordPress when handling a favicon.ico request. + * * Instead, send the headers for a zero-length favicon and bail. * * @since 3.0.0 @@ -122,13 +153,12 @@ function wp_check_php_mysql_versions() { function wp_favicon_request() { if ( '/favicon.ico' == $_SERVER['REQUEST_URI'] ) { header('Content-Type: image/vnd.microsoft.icon'); - header('Content-Length: 0'); exit; } } /** - * Dies with a maintenance message when conditions are met. + * Die with a maintenance message when conditions are met. * * Checks for a file in the WordPress root directory named ".maintenance". * This file will contain the variable $upgrading, set to the time the file @@ -138,11 +168,13 @@ function wp_favicon_request() { * The default message can be replaced by using a drop-in (maintenance.php in * the wp-content directory). * - * @access private * @since 3.0.0 + * @access private + * + * @global int $upgrading the unix timestamp marking when upgrading WordPress began. */ function wp_maintenance() { - if ( !file_exists( ABSPATH . '.maintenance' ) || defined( 'WP_INSTALLING' ) ) + if ( ! file_exists( ABSPATH . '.maintenance' ) || wp_installing() ) return; global $upgrading; @@ -159,9 +191,7 @@ function wp_maintenance() { wp_load_translations_early(); - $protocol = $_SERVER["SERVER_PROTOCOL"]; - if ( 'HTTP/1.1' != $protocol && 'HTTP/1.0' != $protocol ) - $protocol = 'HTTP/1.0'; + $protocol = wp_get_server_protocol(); header( "$protocol 503 Service Unavailable", true, 503 ); header( 'Content-Type: text/html; charset=utf-8' ); header( 'Retry-After: 600' ); @@ -182,11 +212,14 @@ function wp_maintenance() { } /** - * PHP 5 standard microtime start capture. + * Start the WordPress micro-timer. * - * @access private * @since 0.71 - * @global float $timestart Seconds from when function is called. + * @access private + * + * @global float $timestart Unix timestamp set at the beginning of the page load. + * @see timer_stop() + * * @return bool Always returns true. */ function timer_start() { @@ -196,30 +229,21 @@ function timer_start() { } /** - * Return and/or display the time from the page start to when function is called. - * - * You can get the results and print them by doing: - * - * $nTimePageTookToExecute = timer_stop(); - * echo $nTimePageTookToExecute; - * - * - * Or instead, you can do: - * - * timer_stop(1); - * - * which will do what the above does. If you need the result, you can assign it to a variable, but - * in most cases, you only need to echo it. + * Retrieve or display the time from the page start to when function is called. * * @since 0.71 - * @global float $timestart Seconds from when timer_start() is called - * @global float $timeend Seconds from when function is called * - * @param int $display Use '0' or null to not echo anything and 1 to echo the total time - * @param int $precision The amount of digits from the right of the decimal to display. Default is 3. - * @return float The "second.microsecond" finished time calculation + * @global float $timestart Seconds from when timer_start() is called. + * @global float $timeend Seconds from when function is called. + * + * @param int|bool $display Whether to echo or return the results. Accepts 0|false for return, + * 1|true for echo. Default 0|false. + * @param int $precision The number of digits from the right of the decimal to display. + * Default 3. + * @return string The "second.microsecond" finished time calculation. The number is formatted + * for human consumption, both localized and rounded. */ -function timer_stop( $display = 0, $precision = 3 ) { // if called like timer_stop(1), will echo $timetotal +function timer_stop( $display = 0, $precision = 3 ) { global $timestart, $timeend; $timeend = microtime( true ); $timetotal = $timeend - $timestart; @@ -230,33 +254,35 @@ function timer_stop( $display = 0, $precision = 3 ) { // if called like timer_st } /** - * Sets PHP error handling and handles WordPress debug mode. + * Set PHP error reporting based on WordPress debug settings. * - * Uses three constants: WP_DEBUG, WP_DEBUG_DISPLAY, and WP_DEBUG_LOG. All three can be - * defined in wp-config.php. Example: define( 'WP_DEBUG', true ); + * Uses three constants: `WP_DEBUG`, `WP_DEBUG_DISPLAY`, and `WP_DEBUG_LOG`. + * All three can be defined in wp-config.php. By default, `WP_DEBUG` and + * `WP_DEBUG_LOG` are set to false, and `WP_DEBUG_DISPLAY` is set to true. * - * WP_DEBUG_DISPLAY and WP_DEBUG_LOG perform no function unless WP_DEBUG is true. - * WP_DEBUG defaults to false. + * When `WP_DEBUG` is true, all PHP notices are reported. WordPress will also + * display internal notices: when a deprecated WordPress function, function + * argument, or file is used. Deprecated code may be removed from a later + * version. * - * When WP_DEBUG is true, all PHP notices are reported. WordPress will also display - * notices, including one when a deprecated WordPress function, function argument, - * or file is used. Deprecated code may be removed from a later version. + * It is strongly recommended that plugin and theme developers use `WP_DEBUG` + * in their development environments. * - * It is strongly recommended that plugin and theme developers use WP_DEBUG in their - * development environments. + * `WP_DEBUG_DISPLAY` and `WP_DEBUG_LOG` perform no function unless `WP_DEBUG` + * is true. * - * When WP_DEBUG_DISPLAY is true, WordPress will force errors to be displayed. - * WP_DEBUG_DISPLAY defaults to true. Defining it as null prevents WordPress from - * changing the global configuration setting. Defining WP_DEBUG_DISPLAY as false - * will force errors to be hidden. + * When `WP_DEBUG_DISPLAY` is true, WordPress will force errors to be displayed. + * `WP_DEBUG_DISPLAY` defaults to true. Defining it as null prevents WordPress + * from changing the global configuration setting. Defining `WP_DEBUG_DISPLAY` + * as false will force errors to be hidden. * - * When WP_DEBUG_LOG is true, errors will be logged to wp-content/debug.log. - * WP_DEBUG_LOG defaults to false. + * When `WP_DEBUG_LOG` is true, errors will be logged to debug.log in the content + * directory. * - * Errors are never displayed for XML-RPC requests. + * Errors are never displayed for XML-RPC, REST, and Ajax requests. * - * @access private * @since 3.0.0 + * @access private */ function wp_debug_mode() { if ( WP_DEBUG ) { @@ -274,35 +300,49 @@ function wp_debug_mode() { } else { error_reporting( E_CORE_ERROR | E_CORE_WARNING | E_COMPILE_ERROR | E_ERROR | E_WARNING | E_PARSE | E_USER_ERROR | E_USER_WARNING | E_RECOVERABLE_ERROR ); } - if ( defined( 'XMLRPC_REQUEST' ) ) - ini_set( 'display_errors', 0 ); + + if ( defined( 'XMLRPC_REQUEST' ) || defined( 'REST_REQUEST' ) || ( defined( 'DOING_AJAX' ) && DOING_AJAX ) ) { + @ini_set( 'display_errors', 0 ); + } } /** - * Sets the location of the language directory. - * - * To set directory manually, define WP_LANG_DIR in wp-config.php. + * Set the location of the language directory. * - * If the language directory exists within WP_CONTENT_DIR, that is used. - * Otherwise if the language directory exists within WPINC, that's used. - * Finally, if neither of the preceding directories are found, - * WP_CONTENT_DIR/languages is used. + * To set directory manually, define the `WP_LANG_DIR` constant + * in wp-config.php. * - * The WP_LANG_DIR constant was introduced in 2.1.0. + * If the language directory exists within `WP_CONTENT_DIR`, it + * is used. Otherwise the language directory is assumed to live + * in `WPINC`. * - * @access private * @since 3.0.0 + * @access private */ function wp_set_lang_dir() { if ( !defined( 'WP_LANG_DIR' ) ) { if ( file_exists( WP_CONTENT_DIR . '/languages' ) && @is_dir( WP_CONTENT_DIR . '/languages' ) || !@is_dir(ABSPATH . WPINC . '/languages') ) { - define( 'WP_LANG_DIR', WP_CONTENT_DIR . '/languages' ); // no leading slash, no trailing slash, full path, not relative to ABSPATH + /** + * Server path of the language directory. + * + * No leading slash, no trailing slash, full path, not relative to ABSPATH + * + * @since 2.1.0 + */ + define( 'WP_LANG_DIR', WP_CONTENT_DIR . '/languages' ); if ( !defined( 'LANGDIR' ) ) { // Old static relative path maintained for limited backwards compatibility - won't work in some cases define( 'LANGDIR', 'wp-content/languages' ); } } else { - define( 'WP_LANG_DIR', ABSPATH . WPINC . '/languages' ); // no leading slash, no trailing slash, full path, not relative to ABSPATH + /** + * Server path of the language directory. + * + * No leading slash, no trailing slash, full path, not relative to `ABSPATH`. + * + * @since 2.1.0 + */ + define( 'WP_LANG_DIR', ABSPATH . WPINC . '/languages' ); if ( !defined( 'LANGDIR' ) ) { // Old relative path maintained for backwards compatibility define( 'LANGDIR', WPINC . '/languages' ); @@ -312,14 +352,11 @@ function wp_set_lang_dir() { } /** - * Load the correct database class file. - * - * This function is used to load the database class file either at runtime or by - * wp-admin/setup-config.php. We must globalize $wpdb to ensure that it is - * defined globally by the inline code in wp-db.php. + * Load the database class file and instantiate the `$wpdb` global. * * @since 2.5.0 - * @global $wpdb WordPress Database Object + * + * @global wpdb $wpdb The WordPress database class. */ function require_wp_db() { global $wpdb; @@ -335,18 +372,16 @@ function require_wp_db() { } /** - * Sets the database table prefix and the format specifiers for database table columns. - * - * Columns not listed here default to %s. + * Set the database table prefix and the format specifiers for database + * table columns. * - * @see wpdb::$field_types Since 2.8.0 - * @see wpdb::prepare() - * @see wpdb::insert() - * @see wpdb::update() - * @see wpdb::set_prefix() + * Columns not listed here default to `%s`. * - * @access private * @since 3.0.0 + * @access private + * + * @global wpdb $wpdb The WordPress database class. + * @global string $table_prefix The database table prefix. */ function wp_set_wpdb_vars() { global $wpdb, $table_prefix; @@ -365,19 +400,26 @@ function wp_set_wpdb_vars() { if ( is_wp_error( $prefix ) ) { wp_load_translations_early(); - wp_die( __( 'ERROR: $table_prefix in wp-config.php can only contain numbers, letters, and underscores.' ) ); + wp_die( + /* translators: 1: $table_prefix 2: wp-config.php */ + sprintf( __( 'ERROR: %1$s in %2$s can only contain numbers, letters, and underscores.' ), + '$table_prefix', + 'wp-config.php' + ) + ); } } /** - * Access/Modify private global variable $_wp_using_ext_object_cache - * - * Toggle $_wp_using_ext_object_cache on and off without directly touching global + * Toggle `$_wp_using_ext_object_cache` on and off without directly + * touching global. * * @since 3.7.0 * - * @param bool $using Whether external object cache is being used - * @return bool The current 'using' setting + * @global bool $_wp_using_ext_object_cache + * + * @param bool $using Whether external object cache is being used. + * @return bool The current 'using' setting. */ function wp_using_ext_object_cache( $using = null ) { global $_wp_using_ext_object_cache; @@ -388,13 +430,15 @@ function wp_using_ext_object_cache( $using = null ) { } /** - * Starts the WordPress object cache. + * Start the WordPress object cache. * * If an object-cache.php file exists in the wp-content directory, * it uses that drop-in as an external object cache. * - * @access private * @since 3.0.0 + * @access private + * + * @global int $blog_id Blog ID. */ function wp_start_object_cache() { global $blog_id; @@ -408,43 +452,53 @@ function wp_start_object_cache() { } $first_init = true; - } else if ( ! wp_using_ext_object_cache() && file_exists( WP_CONTENT_DIR . '/object-cache.php' ) ) { - // Sometimes advanced-cache.php can load object-cache.php before it is loaded here. - // This breaks the function_exists check above and can result in $_wp_using_ext_object_cache - // being set incorrectly. Double check if an external cache exists. + } elseif ( ! wp_using_ext_object_cache() && file_exists( WP_CONTENT_DIR . '/object-cache.php' ) ) { + /* + * Sometimes advanced-cache.php can load object-cache.php before + * it is loaded here. This breaks the function_exists check above + * and can result in `$_wp_using_ext_object_cache` being set + * incorrectly. Double check if an external cache exists. + */ wp_using_ext_object_cache( true ); } if ( ! wp_using_ext_object_cache() ) require_once ( ABSPATH . WPINC . '/cache.php' ); - // If cache supports reset, reset instead of init if already initialized. - // Reset signals to the cache that global IDs have changed and it may need to update keys - // and cleanup caches. + /* + * If cache supports reset, reset instead of init if already + * initialized. Reset signals to the cache that global IDs + * have changed and it may need to update keys and cleanup caches. + */ if ( ! $first_init && function_exists( 'wp_cache_switch_to_blog' ) ) wp_cache_switch_to_blog( $blog_id ); elseif ( function_exists( 'wp_cache_init' ) ) wp_cache_init(); if ( function_exists( 'wp_cache_add_global_groups' ) ) { - wp_cache_add_global_groups( array( 'users', 'userlogins', 'usermeta', 'user_meta', 'site-transient', 'site-options', 'site-lookup', 'blog-lookup', 'blog-details', 'rss', 'global-posts', 'blog-id-cache' ) ); + wp_cache_add_global_groups( array( 'users', 'userlogins', 'usermeta', 'user_meta', 'useremail', 'userslugs', 'site-transient', 'site-options', 'site-lookup', 'blog-lookup', 'blog-details', 'rss', 'global-posts', 'blog-id-cache', 'networks', 'sites' ) ); wp_cache_add_non_persistent_groups( array( 'comment', 'counts', 'plugins' ) ); } } /** - * Redirects to the installer if WordPress is not installed. + * Redirect to the installer if WordPress is not installed. * - * Dies with an error message when multisite is enabled. + * Dies with an error message when Multisite is enabled. * - * @access private * @since 3.0.0 + * @access private */ function wp_not_installed() { if ( is_multisite() ) { - if ( ! is_blog_installed() && ! defined( 'WP_INSTALLING' ) ) + if ( ! is_blog_installed() && ! wp_installing() ) { + nocache_headers(); + wp_die( __( 'The site you have requested is not installed properly. Please contact the system administrator.' ) ); - } elseif ( ! is_blog_installed() && false === strpos( $_SERVER['PHP_SELF'], 'install.php' ) && !defined( 'WP_INSTALLING' ) ) { + } + } elseif ( ! is_blog_installed() && ! wp_installing() ) { + nocache_headers(); + require( ABSPATH . WPINC . '/kses.php' ); require( ABSPATH . WPINC . '/pluggable.php' ); require( ABSPATH . WPINC . '/formatting.php' ); @@ -457,15 +511,16 @@ function wp_not_installed() { } /** - * Returns array of must-use plugin files to be included in global scope. + * Retrieve an array of must-use plugin files. * - * The default directory is wp-content/mu-plugins. To change the default directory - * manually, define WPMU_PLUGIN_DIR and WPMU_PLUGIN_URL + * The default directory is wp-content/mu-plugins. To change the default + * directory manually, define `WPMU_PLUGIN_DIR` and `WPMU_PLUGIN_URL` * in wp-config.php. * - * @access private * @since 3.0.0 - * @return array Files to include + * @access private + * + * @return array Files to include. */ function wp_get_mu_plugins() { $mu_plugins = array(); @@ -484,15 +539,18 @@ function wp_get_mu_plugins() { } /** - * Returns array of plugin files to be included in global scope. + * Retrieve an array of active and valid plugin files. * - * The default directory is wp-content/plugins. To change the default directory - * manually, define WP_PLUGIN_DIR and WP_PLUGIN_URL + * While upgrading or installing WordPress, no plugins are returned. + * + * The default directory is wp-content/plugins. To change the default + * directory manually, define `WP_PLUGIN_DIR` and `WP_PLUGIN_URL` * in wp-config.php. * - * @access private * @since 3.0.0 - * @return array Files to include + * @access private + * + * @return array Files. */ function wp_get_active_and_valid_plugins() { $plugins = array(); @@ -504,7 +562,7 @@ function wp_get_active_and_valid_plugins() { array_unshift( $plugins, ABSPATH . 'my-hacks.php' ); } - if ( empty( $active_plugins ) || defined( 'WP_INSTALLING' ) ) + if ( empty( $active_plugins ) || wp_installing() ) return $plugins; $network_plugins = is_multisite() ? wp_get_active_network_plugins() : false; @@ -522,13 +580,13 @@ function wp_get_active_and_valid_plugins() { } /** - * Sets internal encoding using mb_internal_encoding(). + * Set internal encoding. * - * In most cases the default internal encoding is latin1, which is of no use, - * since we want to use the mb_ functions for utf-8 strings. + * In most cases the default internal encoding is latin1, which is + * of no use, since we want to use the `mb_` functions for `utf-8` strings. * - * @access private * @since 3.0.0 + * @access private */ function wp_set_internal_encoding() { if ( function_exists( 'mb_internal_encoding' ) ) { @@ -539,13 +597,13 @@ function wp_set_internal_encoding() { } /** - * Add magic quotes to $_GET, $_POST, $_COOKIE, and $_SERVER. + * Add magic quotes to `$_GET`, `$_POST`, `$_COOKIE`, and `$_SERVER`. * - * Also forces $_REQUEST to be $_GET + $_POST. If $_SERVER, $_COOKIE, - * or $_ENV are needed, use those superglobals directly. + * Also forces `$_REQUEST` to be `$_GET + $_POST`. If `$_SERVER`, + * `$_COOKIE`, or `$_ENV` are needed, use those superglobals directly. * - * @access private * @since 3.0.0 + * @access private */ function wp_magic_quotes() { // If already slashed, strip. @@ -568,8 +626,8 @@ function wp_magic_quotes() { /** * Runs just before PHP shuts down execution. * - * @access private * @since 1.2.0 + * @access private */ function shutdown_action_hook() { /** @@ -578,6 +636,7 @@ function shutdown_action_hook() { * @since 1.2.0 */ do_action( 'shutdown' ); + wp_cache_close(); } @@ -585,26 +644,27 @@ function shutdown_action_hook() { * Copy an object. * * @since 2.7.0 - * @deprecated 3.2 + * @deprecated 3.2.0 * - * @param object $object The object to clone - * @return object The cloned object + * @param object $object The object to clone. + * @return object The cloned object. */ - function wp_clone( $object ) { // Use parens for clone to accommodate PHP 4. See #17880 return clone( $object ); } /** - * Whether the current request is for a network or blog admin page + * Whether the current request is for an administrative interface page. * - * Does not inform on whether the user is an admin! Use capability checks to - * tell if the user should be accessing a section or not. + * Does not check if the user is an administrator; {@see current_user_can()} + * for checking roles and capabilities. * * @since 1.5.1 * - * @return bool True if inside WordPress administration pages. + * @global WP_Screen $current_screen + * + * @return bool True if inside WordPress administration interface, false otherwise. */ function is_admin() { if ( isset( $GLOBALS['current_screen'] ) ) @@ -616,14 +676,18 @@ function is_admin() { } /** - * Whether the current request is for a blog admin screen /wp-admin/ + * Whether the current request is for a site's admininstrative interface. + * + * e.g. `/wp-admin/` * - * Does not inform on whether the user is a blog admin! Use capability checks to - * tell if the user should be accessing a section or not. + * Does not check if the user is an administrator; {@see current_user_can()} + * for checking roles and capabilities. * * @since 3.1.0 * - * @return bool True if inside WordPress network administration pages. + * @global WP_Screen $current_screen + * + * @return bool True if inside WordPress blog administration pages. */ function is_blog_admin() { if ( isset( $GLOBALS['current_screen'] ) ) @@ -635,13 +699,17 @@ function is_blog_admin() { } /** - * Whether the current request is for a network admin screen /wp-admin/network/ + * Whether the current request is for the network administrative interface. + * + * e.g. `/wp-admin/network/` * - * Does not inform on whether the user is a network admin! Use capability checks to - * tell if the user should be accessing a section or not. + * Does not check if the user is an administrator; {@see current_user_can()} + * for checking roles and capabilities. * * @since 3.1.0 * + * @global WP_Screen $current_screen + * * @return bool True if inside WordPress network administration pages. */ function is_network_admin() { @@ -654,13 +722,18 @@ function is_network_admin() { } /** - * Whether the current request is for a user admin screen /wp-admin/user/ + * Whether the current request is for a user admin screen. * - * Does not inform on whether the user is an admin! Use capability checks to - * tell if the user should be accessing a section or not. + * e.g. `/wp-admin/user/` + * + * Does not inform on whether the user is an admin! Use capability + * checks to tell if the user should be accessing a section or not + * {@see current_user_can()}. * * @since 3.1.0 * + * @global WP_Screen $current_screen + * * @return bool True if inside WordPress user administration pages. */ function is_user_admin() { @@ -673,11 +746,11 @@ function is_user_admin() { } /** - * Whether Multisite support is enabled + * If Multisite is enabled. * * @since 3.0.0 * - * @return bool True if multisite is enabled, false otherwise. + * @return bool True if Multisite is enabled, false otherwise. */ function is_multisite() { if ( defined( 'MULTISITE' ) ) @@ -690,11 +763,13 @@ function is_multisite() { } /** - * Retrieve the current blog id + * Retrieve the current site ID. * * @since 3.1.0 * - * @return int Blog id + * @global int $blog_id + * + * @return int Site ID. */ function get_current_blog_id() { global $blog_id; @@ -702,16 +777,22 @@ function get_current_blog_id() { } /** - * Attempts an early load of translations. + * Attempt an early load of translations. * - * Used for errors encountered during the initial loading process, before the locale has been - * properly detected and loaded. + * Used for errors encountered during the initial loading process, before + * the locale has been properly detected and loaded. * - * Designed for unusual load sequences (like setup-config.php) or for when the script will then - * terminate with an error, otherwise there is a risk that a file can be double-included. + * Designed for unusual load sequences (like setup-config.php) or for when + * the script will then terminate with an error, otherwise there is a risk + * that a file can be double-included. * * @since 3.4.0 * @access private + * + * @global string $text_direction + * @global WP_Locale $wp_locale The WordPress date and time locale object. + * + * @staticvar bool $loaded */ function wp_load_translations_early() { global $text_direction, $wp_locale; @@ -783,3 +864,34 @@ function wp_load_translations_early() { $wp_locale = new WP_Locale(); } + +/** + * Check or set whether WordPress is in "installation" mode. + * + * If the `WP_INSTALLING` constant is defined during the bootstrap, `wp_installing()` will default to `true`. + * + * @since 4.4.0 + * + * @staticvar bool $installing + * + * @param bool $is_installing Optional. True to set WP into Installing mode, false to turn Installing mode off. + * Omit this parameter if you only want to fetch the current status. + * @return bool True if WP is installing, otherwise false. When a `$is_installing` is passed, the function will + * report whether WP was in installing mode prior to the change to `$is_installing`. + */ +function wp_installing( $is_installing = null ) { + static $installing = null; + + // Support for the `WP_INSTALLING` constant, defined before WP is loaded. + if ( is_null( $installing ) ) { + $installing = defined( 'WP_INSTALLING' ) && WP_INSTALLING; + } + + if ( ! is_null( $is_installing ) ) { + $old_installing = $installing; + $installing = $is_installing; + return (bool) $old_installing; + } + + return (bool) $installing; +}