X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/38ca813a0e312e2768e5b9519f0415cd0aa84781..0459461f9ea42e0b090759ff6fe5f48360bef750:/wp-includes/load.php diff --git a/wp-includes/load.php b/wp-includes/load.php index 4e7c6923..d6345c76 100644 --- a/wp-includes/load.php +++ b/wp-includes/load.php @@ -7,19 +7,33 @@ * @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' ) ) return; if ( isset( $_REQUEST['GLOBALS'] ) ) - die( /*WP_I18N_GLOBALS_OVERWRITE*/'GLOBALS overwrite attempt detected'/*/WP_I18N_GLOBALS_OVERWRITE*/ ); + die( 'GLOBALS overwrite attempt detected' ); // Variables that shouldn't be unset $no_unset = array( 'GLOBALS', '_GET', '_POST', '_COOKIE', '_REQUEST', '_SERVER', '_ENV', '_FILES', 'table_prefix' ); @@ -27,16 +41,18 @@ function wp_unregister_GLOBALS() { $input = array_merge( $_GET, $_POST, $_COOKIE, $_SERVER, $_ENV, $_FILES, isset( $_SESSION ) && is_array( $_SESSION ) ? $_SESSION : array() ); foreach ( $input as $k => $v ) if ( !in_array( $k, $no_unset ) && isset( $GLOBALS[$k] ) ) { - $GLOBALS[$k] = null; unset( $GLOBALS[$k] ); } } /** - * 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; @@ -49,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 @@ -93,30 +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. * - * This function must be able to work without a complete environment set up. In wp-load.php, for - * example, WP_CONTENT_DIR is defined and version.php is included before this function is called. - * - * @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() { - // we can probably extend this function to check if wp_die() exists then use translated strings, and then use it in install.php etc. - global $required_php_version, $wp_version; $php_version = phpversion(); - if ( version_compare( $required_php_version, $php_version, '>' ) ) - die( sprintf( /*WP_I18N_OLD_PHP*/'Your server is running PHP version %1$s but WordPress %2$s requires at least %3$s.'/*/WP_I18N_OLD_PHP*/, $php_version, $wp_version, $required_php_version ) ); - if ( !extension_loaded( 'mysql' ) && !file_exists( WP_CONTENT_DIR . '/db.php' ) ) - die( /*WP_I18N_OLD_MYSQL*/'Your PHP installation appears to be missing the MySQL extension which is required by WordPress.'/*/WP_I18N_OLD_MYSQL*/ ); + 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' ) && ! extension_loaded( 'mysqli' ) && ! 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 @@ -124,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 @@ -140,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,22 +189,22 @@ function wp_maintenance() { die(); } - $protocol = $_SERVER["SERVER_PROTOCOL"]; - if ( 'HTTP/1.1' != $protocol && 'HTTP/1.0' != $protocol ) - $protocol = 'HTTP/1.0'; + wp_load_translations_early(); + + $protocol = wp_get_server_protocol(); header( "$protocol 503 Service Unavailable", true, 503 ); header( 'Content-Type: text/html; charset=utf-8' ); header( 'Retry-After: 600' ); ?> - - + + > - <?php echo /*WP_I18N_MAINTENANCE*/'Maintenance'/*/WP_I18N_MAINTENANCE*/; ?> + <?php _e( 'Maintenance' ); ?> -

+

- * $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 - * 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 int $timestart Seconds and Microseconds added together from when timer_start() is called - * @global int $timeend Seconds and Microseconds added together 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; - $mtime = microtime(); - $mtime = explode( ' ', $mtime ); - $timeend = $mtime[1] + $mtime[0]; + $timeend = microtime( true ); $timetotal = $timeend - $timestart; $r = ( function_exists( 'number_format_i18n' ) ) ? number_format_i18n( $timetotal, $precision ) : number_format( $timetotal, $precision ); if ( $display ) @@ -233,43 +254,43 @@ 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, and by default are set to false. * - * 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 false prevents WordPress from - * changing the global configuration setting. (Defining WP_DEBUG_DISPLAY as false - * will never 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. * - * @access private * @since 3.0.0 + * @access private */ function wp_debug_mode() { if ( WP_DEBUG ) { - // E_DEPRECATED is a core PHP constant in PHP 5.3. Don't define this yourself. - // The two statements are equivalent, just one is for 5.3+ and for less than 5.3. - if ( defined( 'E_DEPRECATED' ) ) - error_reporting( E_ALL & ~E_DEPRECATED & ~E_STRICT ); - else - error_reporting( E_ALL ); + error_reporting( E_ALL ); if ( WP_DEBUG_DISPLAY ) ini_set( 'display_errors', 1 ); + elseif ( null !== WP_DEBUG_DISPLAY ) + ini_set( 'display_errors', 0 ); if ( WP_DEBUG_LOG ) { ini_set( 'log_errors', 1 ); @@ -278,33 +299,47 @@ 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 ); } /** - * Sets the location of the language directory. + * Set the location of the language directory. * - * To set directory manually, define WP_LANG_DIR in wp-config.php. - * - * 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 preceeding directories is 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' ); @@ -314,14 +349,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; @@ -337,18 +369,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; @@ -356,7 +386,7 @@ function wp_set_wpdb_vars() { dead_db(); $wpdb->field_types = array( 'post_author' => '%d', 'post_parent' => '%d', 'menu_order' => '%d', 'term_id' => '%d', 'term_group' => '%d', 'term_taxonomy_id' => '%d', - 'parent' => '%d', 'count' => '%d','object_id' => '%d', 'term_order' => '%d', 'ID' => '%d', 'commment_ID' => '%d', 'comment_post_ID' => '%d', 'comment_parent' => '%d', + 'parent' => '%d', 'count' => '%d','object_id' => '%d', 'term_order' => '%d', 'ID' => '%d', 'comment_ID' => '%d', 'comment_post_ID' => '%d', 'comment_parent' => '%d', 'user_id' => '%d', 'link_id' => '%d', 'link_owner' => '%d', 'link_rating' => '%d', 'option_id' => '%d', 'blog_id' => '%d', 'meta_id' => '%d', 'post_id' => '%d', 'user_status' => '%d', 'umeta_id' => '%d', 'comment_karma' => '%d', 'comment_count' => '%d', // multisite: @@ -365,87 +395,129 @@ function wp_set_wpdb_vars() { $prefix = $wpdb->set_prefix( $table_prefix ); - if ( is_wp_error( $prefix ) ) - wp_die( /*WP_I18N_BAD_PREFIX*/'ERROR: $table_prefix in wp-config.php can only contain numbers, letters, and underscores.'/*/WP_I18N_BAD_PREFIX*/ ); + if ( is_wp_error( $prefix ) ) { + wp_load_translations_early(); + 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' + ) + ); + } +} + +/** + * Toggle `$_wp_using_ext_object_cache` on and off without directly + * touching global. + * + * @since 3.7.0 + * + * @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; + $current_using = $_wp_using_ext_object_cache; + if ( null !== $using ) + $_wp_using_ext_object_cache = $using; + return $current_using; } /** - * 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 $_wp_using_ext_object_cache; + global $blog_id; $first_init = false; if ( ! function_exists( 'wp_cache_init' ) ) { if ( file_exists( WP_CONTENT_DIR . '/object-cache.php' ) ) { require_once ( WP_CONTENT_DIR . '/object-cache.php' ); - $_wp_using_ext_object_cache = true; - } else { - require_once ( ABSPATH . WPINC . '/cache.php' ); - $_wp_using_ext_object_cache = false; + if ( function_exists( 'wp_cache_init' ) ) + wp_using_ext_object_cache( true ); } + $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. - $_wp_using_ext_object_cache = true; + } 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 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_reset') ) - wp_cache_reset(); - else + 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 ( ! $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' ) ); + 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' ) ); 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' ) ) - 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' ) ) { + if ( ! is_blog_installed() && ! wp_installing() ) { + nocache_headers(); - $link = wp_guess_url() . '/wp-admin/install.php'; + wp_die( __( 'The site you have requested is not installed properly. Please contact the system administrator.' ) ); + } + } elseif ( ! is_blog_installed() && ! wp_installing() ) { + nocache_headers(); require( ABSPATH . WPINC . '/kses.php' ); require( ABSPATH . WPINC . '/pluggable.php' ); require( ABSPATH . WPINC . '/formatting.php' ); + + $link = wp_guess_url() . '/wp-admin/install.php'; + wp_redirect( $link ); die(); } } /** - * 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(); @@ -464,15 +536,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. + * + * 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 + * 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(); @@ -484,7 +559,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; @@ -502,29 +577,30 @@ 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' ) ) { - if ( !@mb_internal_encoding( get_option( 'blog_charset' ) ) ) + $charset = get_option( 'blog_charset' ); + if ( ! $charset || ! @mb_internal_encoding( $charset ) ) mb_internal_encoding( 'UTF-8' ); } } /** - * 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. @@ -547,11 +623,17 @@ function wp_magic_quotes() { /** * Runs just before PHP shuts down execution. * - * @access private * @since 1.2.0 + * @access private */ function shutdown_action_hook() { + /** + * Fires just before PHP shuts down execution. + * + * @since 1.2.0 + */ do_action( 'shutdown' ); + wp_cache_close(); } @@ -559,87 +641,113 @@ 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 + // 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 ( defined( 'WP_ADMIN' ) ) + if ( isset( $GLOBALS['current_screen'] ) ) + return $GLOBALS['current_screen']->in_admin(); + elseif ( defined( 'WP_ADMIN' ) ) return WP_ADMIN; + return false; } /** - * Whether the current request is for a blog admin screen /wp-admin/ + * Whether the current request is for a site's admininstrative interface. * - * 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. + * e.g. `/wp-admin/` + * + * 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 ( defined( 'WP_BLOG_ADMIN' ) ) + if ( isset( $GLOBALS['current_screen'] ) ) + return $GLOBALS['current_screen']->in_admin( 'site' ); + elseif ( defined( 'WP_BLOG_ADMIN' ) ) return WP_BLOG_ADMIN; + return false; } /** - * 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() { - if ( defined( 'WP_NETWORK_ADMIN' ) ) + if ( isset( $GLOBALS['current_screen'] ) ) + return $GLOBALS['current_screen']->in_admin( 'network' ); + elseif ( defined( 'WP_NETWORK_ADMIN' ) ) return WP_NETWORK_ADMIN; + return false; } /** - * 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() { - if ( defined( 'WP_USER_ADMIN' ) ) + if ( isset( $GLOBALS['current_screen'] ) ) + return $GLOBALS['current_screen']->in_admin( 'user' ); + elseif ( defined( 'WP_USER_ADMIN' ) ) return WP_USER_ADMIN; + return false; } /** - * 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' ) ) @@ -651,4 +759,136 @@ function is_multisite() { return false; } -?> +/** + * Retrieve the current blog ID. + * + * @since 3.1.0 + * + * @global int $blog_id + * + * @return int Blog id + */ +function get_current_blog_id() { + global $blog_id; + return absint($blog_id); +} + +/** + * Attempt an early load of translations. + * + * 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. + * + * @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; + + static $loaded = false; + if ( $loaded ) + return; + $loaded = true; + + if ( function_exists( 'did_action' ) && did_action( 'init' ) ) + return; + + // We need $wp_local_package + require ABSPATH . WPINC . '/version.php'; + + // Translation and localization + require_once ABSPATH . WPINC . '/pomo/mo.php'; + require_once ABSPATH . WPINC . '/l10n.php'; + require_once ABSPATH . WPINC . '/locale.php'; + + // General libraries + require_once ABSPATH . WPINC . '/plugin.php'; + + $locales = $locations = array(); + + while ( true ) { + if ( defined( 'WPLANG' ) ) { + if ( '' == WPLANG ) + break; + $locales[] = WPLANG; + } + + if ( isset( $wp_local_package ) ) + $locales[] = $wp_local_package; + + if ( ! $locales ) + break; + + if ( defined( 'WP_LANG_DIR' ) && @is_dir( WP_LANG_DIR ) ) + $locations[] = WP_LANG_DIR; + + if ( defined( 'WP_CONTENT_DIR' ) && @is_dir( WP_CONTENT_DIR . '/languages' ) ) + $locations[] = WP_CONTENT_DIR . '/languages'; + + if ( @is_dir( ABSPATH . 'wp-content/languages' ) ) + $locations[] = ABSPATH . 'wp-content/languages'; + + if ( @is_dir( ABSPATH . WPINC . '/languages' ) ) + $locations[] = ABSPATH . WPINC . '/languages'; + + if ( ! $locations ) + break; + + $locations = array_unique( $locations ); + + foreach ( $locales as $locale ) { + foreach ( $locations as $location ) { + if ( file_exists( $location . '/' . $locale . '.mo' ) ) { + load_textdomain( 'default', $location . '/' . $locale . '.mo' ); + if ( defined( 'WP_SETUP_CONFIG' ) && file_exists( $location . '/admin-' . $locale . '.mo' ) ) + load_textdomain( 'default', $location . '/admin-' . $locale . '.mo' ); + break 2; + } + } + } + + break; + } + + $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; +}