3 * Used to set up and fix common variables and include
4 * the WordPress procedural and class library.
6 * Allows for some configuration in wp-config.php (see default-constants.php)
8 * @internal This file must be parsable by PHP4.
14 * Stores the location of the WordPress directory of functions, classes, and core content.
18 define( 'WPINC', 'wp-includes' );
20 // Include files required for initialization.
21 require( ABSPATH . WPINC . '/load.php' );
22 require( ABSPATH . WPINC . '/default-constants.php' );
23 require( ABSPATH . WPINC . '/plugin.php' );
26 * These can't be directly globalized in version.php. When updating,
27 * we're including version.php from another install and don't want
28 * these values to be overridden if already set.
30 global $wp_version, $wp_db_version, $tinymce_version, $required_php_version, $required_mysql_version, $wp_local_package;
31 require( ABSPATH . WPINC . '/version.php' );
34 * If not already configured, `$blog_id` will default to 1 in a single site
35 * configuration. In multisite, it will be overridden by default in ms-settings.php.
37 * @global int $blog_id
42 // Set initial default constants including WP_MEMORY_LIMIT, WP_MAX_MEMORY_LIMIT, WP_DEBUG, SCRIPT_DEBUG, WP_CONTENT_DIR and WP_CACHE.
43 wp_initial_constants();
45 // Check for the required PHP version and for the MySQL extension or a database drop-in.
46 wp_check_php_mysql_versions();
48 // Disable magic quotes at runtime. Magic quotes are added using wpdb later in wp-settings.php.
49 @ini_set( 'magic_quotes_runtime', 0 );
50 @ini_set( 'magic_quotes_sybase', 0 );
52 // WordPress calculates offsets from UTC.
53 date_default_timezone_set( 'UTC' );
55 // Turn register_globals off.
56 wp_unregister_GLOBALS();
58 // Standardize $_SERVER variables across setups.
61 // Check if we have received a request due to missing favicon.ico
64 // Check if we're in maintenance mode.
67 // Start loading timer.
70 // Check if we're in WP_DEBUG mode.
74 * Filters whether to enable loading of the advanced-cache.php drop-in.
76 * This filter runs before it can be used by plugins. It is designed for non-web
77 * run-times. If false is returned, advanced-cache.php will never be loaded.
81 * @param bool $enable_advanced_cache Whether to enable loading advanced-cache.php (if present).
84 if ( WP_CACHE && apply_filters( 'enable_loading_advanced_cache_dropin', true ) ) {
85 // For an advanced caching plugin to use. Uses a static drop-in because you would only want one.
86 WP_DEBUG ? include( WP_CONTENT_DIR . '/advanced-cache.php' ) : @include( WP_CONTENT_DIR . '/advanced-cache.php' );
89 // Define WP_LANG_DIR if not set.
92 // Load early WordPress files.
93 require( ABSPATH . WPINC . '/compat.php' );
94 require( ABSPATH . WPINC . '/functions.php' );
95 require( ABSPATH . WPINC . '/class-wp.php' );
96 require( ABSPATH . WPINC . '/class-wp-error.php' );
97 require( ABSPATH . WPINC . '/pomo/mo.php' );
99 // Include the wpdb class and, if present, a db.php database drop-in.
103 // Set the database table prefix and the format specifiers for database table columns.
104 $GLOBALS['table_prefix'] = $table_prefix;
107 // Start the WordPress object cache, or an external object cache if the drop-in is present.
108 wp_start_object_cache();
110 // Attach the default filters.
111 require( ABSPATH . WPINC . '/default-filters.php' );
113 // Initialize multisite if enabled.
114 if ( is_multisite() ) {
115 require( ABSPATH . WPINC . '/class-wp-site-query.php' );
116 require( ABSPATH . WPINC . '/class-wp-network-query.php' );
117 require( ABSPATH . WPINC . '/ms-blogs.php' );
118 require( ABSPATH . WPINC . '/ms-settings.php' );
119 } elseif ( ! defined( 'MULTISITE' ) ) {
120 define( 'MULTISITE', false );
123 register_shutdown_function( 'shutdown_action_hook' );
125 // Stop most of WordPress from being loaded if we just want the basics.
129 // Load the L10n library.
130 require_once( ABSPATH . WPINC . '/l10n.php' );
132 // Run the installer if WordPress is not installed.
135 // Load most of WordPress.
136 require( ABSPATH . WPINC . '/class-wp-walker.php' );
137 require( ABSPATH . WPINC . '/class-wp-ajax-response.php' );
138 require( ABSPATH . WPINC . '/formatting.php' );
139 require( ABSPATH . WPINC . '/capabilities.php' );
140 require( ABSPATH . WPINC . '/class-wp-roles.php' );
141 require( ABSPATH . WPINC . '/class-wp-role.php' );
142 require( ABSPATH . WPINC . '/class-wp-user.php' );
143 require( ABSPATH . WPINC . '/query.php' );
144 require( ABSPATH . WPINC . '/date.php' );
145 require( ABSPATH . WPINC . '/theme.php' );
146 require( ABSPATH . WPINC . '/class-wp-theme.php' );
147 require( ABSPATH . WPINC . '/template.php' );
148 require( ABSPATH . WPINC . '/user.php' );
149 require( ABSPATH . WPINC . '/class-wp-user-query.php' );
150 require( ABSPATH . WPINC . '/session.php' );
151 require( ABSPATH . WPINC . '/meta.php' );
152 require( ABSPATH . WPINC . '/class-wp-meta-query.php' );
153 require( ABSPATH . WPINC . '/class-wp-metadata-lazyloader.php' );
154 require( ABSPATH . WPINC . '/general-template.php' );
155 require( ABSPATH . WPINC . '/link-template.php' );
156 require( ABSPATH . WPINC . '/author-template.php' );
157 require( ABSPATH . WPINC . '/post.php' );
158 require( ABSPATH . WPINC . '/class-walker-page.php' );
159 require( ABSPATH . WPINC . '/class-walker-page-dropdown.php' );
160 require( ABSPATH . WPINC . '/class-wp-post-type.php' );
161 require( ABSPATH . WPINC . '/class-wp-post.php' );
162 require( ABSPATH . WPINC . '/post-template.php' );
163 require( ABSPATH . WPINC . '/revision.php' );
164 require( ABSPATH . WPINC . '/post-formats.php' );
165 require( ABSPATH . WPINC . '/post-thumbnail-template.php' );
166 require( ABSPATH . WPINC . '/category.php' );
167 require( ABSPATH . WPINC . '/class-walker-category.php' );
168 require( ABSPATH . WPINC . '/class-walker-category-dropdown.php' );
169 require( ABSPATH . WPINC . '/category-template.php' );
170 require( ABSPATH . WPINC . '/comment.php' );
171 require( ABSPATH . WPINC . '/class-wp-comment.php' );
172 require( ABSPATH . WPINC . '/class-wp-comment-query.php' );
173 require( ABSPATH . WPINC . '/class-walker-comment.php' );
174 require( ABSPATH . WPINC . '/comment-template.php' );
175 require( ABSPATH . WPINC . '/rewrite.php' );
176 require( ABSPATH . WPINC . '/class-wp-rewrite.php' );
177 require( ABSPATH . WPINC . '/feed.php' );
178 require( ABSPATH . WPINC . '/bookmark.php' );
179 require( ABSPATH . WPINC . '/bookmark-template.php' );
180 require( ABSPATH . WPINC . '/kses.php' );
181 require( ABSPATH . WPINC . '/cron.php' );
182 require( ABSPATH . WPINC . '/deprecated.php' );
183 require( ABSPATH . WPINC . '/script-loader.php' );
184 require( ABSPATH . WPINC . '/taxonomy.php' );
185 require( ABSPATH . WPINC . '/class-wp-term.php' );
186 require( ABSPATH . WPINC . '/class-wp-term-query.php' );
187 require( ABSPATH . WPINC . '/class-wp-tax-query.php' );
188 require( ABSPATH . WPINC . '/update.php' );
189 require( ABSPATH . WPINC . '/canonical.php' );
190 require( ABSPATH . WPINC . '/shortcodes.php' );
191 require( ABSPATH . WPINC . '/embed.php' );
192 require( ABSPATH . WPINC . '/class-wp-embed.php' );
193 require( ABSPATH . WPINC . '/class-wp-oembed-controller.php' );
194 require( ABSPATH . WPINC . '/media.php' );
195 require( ABSPATH . WPINC . '/http.php' );
196 require( ABSPATH . WPINC . '/class-http.php' );
197 require( ABSPATH . WPINC . '/class-wp-http-streams.php' );
198 require( ABSPATH . WPINC . '/class-wp-http-curl.php' );
199 require( ABSPATH . WPINC . '/class-wp-http-proxy.php' );
200 require( ABSPATH . WPINC . '/class-wp-http-cookie.php' );
201 require( ABSPATH . WPINC . '/class-wp-http-encoding.php' );
202 require( ABSPATH . WPINC . '/class-wp-http-response.php' );
203 require( ABSPATH . WPINC . '/class-wp-http-requests-response.php' );
204 require( ABSPATH . WPINC . '/widgets.php' );
205 require( ABSPATH . WPINC . '/class-wp-widget.php' );
206 require( ABSPATH . WPINC . '/class-wp-widget-factory.php' );
207 require( ABSPATH . WPINC . '/nav-menu.php' );
208 require( ABSPATH . WPINC . '/nav-menu-template.php' );
209 require( ABSPATH . WPINC . '/admin-bar.php' );
210 require( ABSPATH . WPINC . '/rest-api.php' );
211 require( ABSPATH . WPINC . '/rest-api/class-wp-rest-server.php' );
212 require( ABSPATH . WPINC . '/rest-api/class-wp-rest-response.php' );
213 require( ABSPATH . WPINC . '/rest-api/class-wp-rest-request.php' );
215 // Load multisite-specific files.
216 if ( is_multisite() ) {
217 require( ABSPATH . WPINC . '/ms-functions.php' );
218 require( ABSPATH . WPINC . '/ms-default-filters.php' );
219 require( ABSPATH . WPINC . '/ms-deprecated.php' );
222 // Define constants that rely on the API to obtain the default value.
223 // Define must-use plugin directory constants, which may be overridden in the sunrise.php drop-in.
224 wp_plugin_directory_constants();
226 $GLOBALS['wp_plugin_paths'] = array();
228 // Load must-use plugins.
229 foreach ( wp_get_mu_plugins() as $mu_plugin ) {
230 include_once( $mu_plugin );
234 // Load network activated plugins.
235 if ( is_multisite() ) {
236 foreach ( wp_get_active_network_plugins() as $network_plugin ) {
237 wp_register_plugin_realpath( $network_plugin );
238 include_once( $network_plugin );
240 unset( $network_plugin );
244 * Fires once all must-use and network-activated plugins have loaded.
248 do_action( 'muplugins_loaded' );
250 if ( is_multisite() )
251 ms_cookie_constants( );
253 // Define constants after multisite is loaded.
254 wp_cookie_constants();
256 // Define and enforce our SSL constants
259 // Create common globals.
260 require( ABSPATH . WPINC . '/vars.php' );
262 // Make taxonomies and posts available to plugins and themes.
263 // @plugin authors: warning: these get registered again on the init hook.
264 create_initial_taxonomies();
265 create_initial_post_types();
267 // Register the default theme directory root
268 register_theme_directory( get_theme_root() );
270 // Load active plugins.
271 foreach ( wp_get_active_and_valid_plugins() as $plugin ) {
272 wp_register_plugin_realpath( $plugin );
273 include_once( $plugin );
277 // Load pluggable functions.
278 require( ABSPATH . WPINC . '/pluggable.php' );
279 require( ABSPATH . WPINC . '/pluggable-deprecated.php' );
281 // Set internal encoding.
282 wp_set_internal_encoding();
284 // Run wp_cache_postload() if object cache is enabled and the function exists.
285 if ( WP_CACHE && function_exists( 'wp_cache_postload' ) )
289 * Fires once activated plugins have loaded.
291 * Pluggable functions are also available at this point in the loading order.
295 do_action( 'plugins_loaded' );
297 // Define constants which affect functionality if not already defined.
298 wp_functionality_constants();
300 // Add magic quotes and set up $_REQUEST ( $_GET + $_POST )
304 * Fires when comment cookies are sanitized.
308 do_action( 'sanitize_comment_cookies' );
311 * WordPress Query object
312 * @global WP_Query $wp_the_query
315 $GLOBALS['wp_the_query'] = new WP_Query();
318 * Holds the reference to @see $wp_the_query
319 * Use this global for WordPress queries
320 * @global WP_Query $wp_query
323 $GLOBALS['wp_query'] = $GLOBALS['wp_the_query'];
326 * Holds the WordPress Rewrite object for creating pretty URLs
327 * @global WP_Rewrite $wp_rewrite
330 $GLOBALS['wp_rewrite'] = new WP_Rewrite();
337 $GLOBALS['wp'] = new WP();
340 * WordPress Widget Factory Object
341 * @global WP_Widget_Factory $wp_widget_factory
344 $GLOBALS['wp_widget_factory'] = new WP_Widget_Factory();
347 * WordPress User Roles
348 * @global WP_Roles $wp_roles
351 $GLOBALS['wp_roles'] = new WP_Roles();
354 * Fires before the theme is loaded.
358 do_action( 'setup_theme' );
360 // Define the template related constants.
361 wp_templating_constants( );
363 // Load the default text localization domain.
364 load_default_textdomain();
366 $locale = get_locale();
367 $locale_file = WP_LANG_DIR . "/$locale.php";
368 if ( ( 0 === validate_file( $locale ) ) && is_readable( $locale_file ) )
369 require( $locale_file );
370 unset( $locale_file );
372 // Pull in locale data after loading text domain.
373 require_once( ABSPATH . WPINC . '/locale.php' );
376 * WordPress Locale object for loading locale domain date and various strings.
377 * @global WP_Locale $wp_locale
380 $GLOBALS['wp_locale'] = new WP_Locale();
382 // Load the functions for the active theme, for both parent and child theme if applicable.
383 if ( ! wp_installing() || 'wp-activate.php' === $pagenow ) {
384 if ( TEMPLATEPATH !== STYLESHEETPATH && file_exists( STYLESHEETPATH . '/functions.php' ) )
385 include( STYLESHEETPATH . '/functions.php' );
386 if ( file_exists( TEMPLATEPATH . '/functions.php' ) )
387 include( TEMPLATEPATH . '/functions.php' );
391 * Fires after the theme is loaded.
395 do_action( 'after_setup_theme' );
397 // Set up current user.
398 $GLOBALS['wp']->init();
401 * Fires after WordPress has finished loading but before any headers are sent.
403 * Most of WP is loaded at this stage, and the user is authenticated. WP continues
404 * to load on the {@see 'init'} hook that follows (e.g. widgets), and many plugins instantiate
405 * themselves on it for all sorts of reasons (e.g. they need a user, a taxonomy, etc.).
407 * If you wish to plug an action once WP is loaded, use the {@see 'wp_loaded'} hook below.
414 if ( is_multisite() ) {
415 if ( true !== ( $file = ms_site_check() ) ) {
423 * This hook is fired once WP, all plugins, and the theme are fully loaded and instantiated.
425 * Ajax requests should use wp-admin/admin-ajax.php. admin-ajax.php can handle requests for
426 * users not logged in.
428 * @link https://codex.wordpress.org/AJAX_in_Plugins
432 do_action( 'wp_loaded' );