X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/4feeb71a9d812a9ae371c28a3d8b442a4394ded7..607b7e02d77e7326161e8ec15639052d2040f745:/wp-includes/load.php?ds=inline diff --git a/wp-includes/load.php b/wp-includes/load.php index a6135be1..11c36fda 100644 --- a/wp-includes/load.php +++ b/wp-includes/load.php @@ -184,6 +184,23 @@ function wp_maintenance() { if ( ( time() - $upgrading ) >= 600 ) return; + /** + * Filters whether to enable maintenance mode. + * + * This filter runs before it can be used by plugins. It is designed for + * non-web runtimes. If this filter returns true, maintenance mode will be + * active and the request will end. If false, the request will be allowed to + * continue processing even if maintenance mode should be active. + * + * @since 4.6.0 + * + * @param bool $enable_checks Whether to enable maintenance mode. Default true. + * @param int $upgrading The timestamp set in the .maintenance file. + */ + if ( ! apply_filters( 'enable_maintenance_mode', true, $upgrading ) ) { + return; + } + if ( file_exists( WP_CONTENT_DIR . '/maintenance.php' ) ) { require_once( WP_CONTENT_DIR . '/maintenance.php' ); die(); @@ -285,6 +302,22 @@ function timer_stop( $display = 0, $precision = 3 ) { * @access private */ function wp_debug_mode() { + /** + * Filters whether to allow the debug mode check to occur. + * + * This filter runs before it can be used by plugins. It is designed for + * non-web run-times. Returning false causes the `WP_DEBUG` and related + * constants to not be checked and the default php values for errors + * will be used unless you take care to update them yourself. + * + * @since 4.6.0 + * + * @param bool $enable_debug_mode Whether to enable debug mode checks to occur. Default true. + */ + if ( ! apply_filters( 'enable_wp_debug_mode_checks', true ) ){ + return; + } + if ( WP_DEBUG ) { error_reporting( E_ALL ); @@ -331,7 +364,7 @@ function wp_set_lang_dir() { */ 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 + // Old static relative path maintained for limited backward compatibility - won't work in some cases. define( 'LANGDIR', 'wp-content/languages' ); } } else { @@ -344,7 +377,7 @@ function wp_set_lang_dir() { */ define( 'WP_LANG_DIR', ABSPATH . WPINC . '/languages' ); if ( !defined( 'LANGDIR' ) ) { - // Old relative path maintained for backwards compatibility + // Old relative path maintained for backward compatibility. define( 'LANGDIR', WPINC . '/languages' ); } } @@ -476,8 +509,8 @@ function wp_start_object_cache() { wp_cache_init(); if ( function_exists( 'wp_cache_add_global_groups' ) ) { - 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' ) ); + wp_cache_add_global_groups( array( 'users', 'userlogins', 'usermeta', 'user_meta', 'useremail', 'userslugs', 'site-transient', 'site-options', 'site-lookup', 'blog-lookup', 'blog-details', 'site-details', 'rss', 'global-posts', 'blog-id-cache', 'networks', 'sites' ) ); + wp_cache_add_non_persistent_groups( array( 'counts', 'plugins' ) ); } } @@ -558,7 +591,7 @@ function wp_get_active_and_valid_plugins() { // Check for hacks file if the option is enabled if ( get_option( 'hack_file' ) && file_exists( ABSPATH . 'my-hacks.php' ) ) { - _deprecated_file( 'my-hacks.php', '1.5' ); + _deprecated_file( 'my-hacks.php', '1.5.0' ); array_unshift( $plugins, ABSPATH . 'my-hacks.php' ); } @@ -657,7 +690,7 @@ function wp_clone( $object ) { /** * Whether the current request is for an administrative interface page. * - * Does not check if the user is an administrator; {@see current_user_can()} + * Does not check if the user is an administrator; current_user_can() * for checking roles and capabilities. * * @since 1.5.1 @@ -680,7 +713,7 @@ function is_admin() { * * e.g. `/wp-admin/` * - * Does not check if the user is an administrator; {@see current_user_can()} + * Does not check if the user is an administrator; current_user_can() * for checking roles and capabilities. * * @since 3.1.0 @@ -703,7 +736,7 @@ function is_blog_admin() { * * e.g. `/wp-admin/network/` * - * Does not check if the user is an administrator; {@see current_user_can()} + * Does not check if the user is an administrator; current_user_can() * for checking roles and capabilities. * * @since 3.1.0 @@ -728,7 +761,7 @@ function is_network_admin() { * * 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()}. + * current_user_can(). * * @since 3.1.0 * @@ -776,6 +809,29 @@ function get_current_blog_id() { return absint($blog_id); } +/** + * Retrieves the current network ID. + * + * @since 4.6.0 + * + * @global WP_Network $current_site The current network. + * + * @return int The ID of the current network. + */ +function get_current_network_id() { + if ( ! is_multisite() ) { + return 1; + } + + $current_site = get_current_site(); + + if ( ! isset( $current_site->id ) ) { + return get_main_network_id(); + } + + return absint( $current_site->id ); +} + /** * Attempt an early load of translations. * @@ -895,3 +951,79 @@ function wp_installing( $is_installing = null ) { return (bool) $installing; } + +/** + * Determines if SSL is used. + * + * @since 2.6.0 + * @since 4.6.0 Moved from functions.php to load.php. + * + * @return bool True if SSL, otherwise false. + */ +function is_ssl() { + if ( isset( $_SERVER['HTTPS'] ) ) { + if ( 'on' == strtolower( $_SERVER['HTTPS'] ) ) { + return true; + } + + if ( '1' == $_SERVER['HTTPS'] ) { + return true; + } + } elseif ( isset($_SERVER['SERVER_PORT'] ) && ( '443' == $_SERVER['SERVER_PORT'] ) ) { + return true; + } + return false; +} + +/** + * Converts a shorthand byte value to an integer byte value. + * + * @since 2.3.0 + * @since 4.6.0 Moved from media.php to load.php. + * + * @link http://php.net/manual/en/function.ini-get.php + * @link http://php.net/manual/en/faq.using.php#faq.using.shorthandbytes + * + * @param string $value A (PHP ini) byte value, either shorthand or ordinary. + * @return int An integer byte value. + */ +function wp_convert_hr_to_bytes( $value ) { + $value = strtolower( trim( $value ) ); + $bytes = (int) $value; + + if ( false !== strpos( $value, 'g' ) ) { + $bytes *= GB_IN_BYTES; + } elseif ( false !== strpos( $value, 'm' ) ) { + $bytes *= MB_IN_BYTES; + } elseif ( false !== strpos( $value, 'k' ) ) { + $bytes *= KB_IN_BYTES; + } + + // Deal with large (float) values which run into the maximum integer size. + return min( $bytes, PHP_INT_MAX ); +} + +/** + * Determines whether a PHP ini value is changeable at runtime. + * + * @since 4.6.0 + * + * @link http://php.net/manual/en/function.ini-get-all.php + * + * @param string $setting The name of the ini setting to check. + * @return bool True if the value is changeable at runtime. False otherwise. + */ +function wp_is_ini_value_changeable( $setting ) { + static $ini_all; + + if ( ! isset( $ini_all ) ) { + $ini_all = ini_get_all(); + } + + // Bit operator to workaround https://bugs.php.net/bug.php?id=44936 which changes access level to 63 in PHP 5.2.6 - 5.2.17. + if ( isset( $ini_all[ $setting ]['access'] ) && ( INI_ALL === ( $ini_all[ $setting ]['access'] & 7 ) || INI_USER === ( $ini_all[ $setting ]['access'] & 7 ) ) ) { + return true; + } + + return false; +}