WordPress PHP Cross Reference Blogging Systems

Source: /wp-settings.php - 432 lines - 13920 bytes - Summary - Text - Print

Description: Used to set up and fix common variables and include the WordPress procedural and class library. Allows for some configuration in wp-config.php (see default-constants.php)

   1  <?php
   2  /**
   3   * Used to set up and fix common variables and include
   4   * the WordPress procedural and class library.
   5   *
   6   * Allows for some configuration in wp-config.php (see default-constants.php)
   7   *
   8   * @internal This file must be parsable by PHP4.
   9   *
  10   * @package WordPress
  11   */
  12  
  13  /**
  14   * Stores the location of the WordPress directory of functions, classes, and core content.
  15   *
  16   * @since 1.0.0
  17   */
  18  define( 'WPINC', 'wp-includes' );
  19  
  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' );
  24  
  25  /*
  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.
  29   */
  30  global $wp_version, $wp_db_version, $tinymce_version, $required_php_version, $required_mysql_version, $wp_local_package;
  31  require ( ABSPATH . WPINC . '/version.php' );
  32  
  33  /**
  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.
  36   *
  37   * @global int $blog_id
  38   * @since 2.0.0
  39   */
  40  global $blog_id;
  41  
  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();
  44  
  45  // Check for the required PHP version and for the MySQL extension or a database drop-in.
  46  wp_check_php_mysql_versions();
  47  
  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 );
  51  
  52  // WordPress calculates offsets from UTC.
  53  date_default_timezone_set( 'UTC' );
  54  
  55  // Turn register_globals off.
  56  wp_unregister_GLOBALS();
  57  
  58  // Standardize $_SERVER variables across setups.
  59  wp_fix_server_vars();
  60  
  61  // Check if we have received a request due to missing favicon.ico
  62  wp_favicon_request();
  63  
  64  // Check if we're in maintenance mode.
  65  wp_maintenance();
  66  
  67  // Start loading timer.
  68  timer_start();
  69  
  70  // Check if we're in WP_DEBUG mode.
  71  wp_debug_mode();
  72  
  73  /**
  74   * Filters whether to enable loading of the advanced-cache.php drop-in.
  75   *
  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.
  78   *
  79   * @since 4.6.0
  80   *
  81   * @param bool $enable_advanced_cache Whether to enable loading advanced-cache.php (if present).
  82   *                                    Default true.
  83   */
  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' );
  87  }
  88  
  89  // Define WP_LANG_DIR if not set.
  90  wp_set_lang_dir();
  91  
  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' );
  98  
  99  // Include the wpdb class and, if present, a db.php database drop-in.
 100  global $wpdb;
 101  require_wp_db();
 102  
 103  // Set the database table prefix and the format specifiers for database table columns.
 104  $GLOBALS['table_prefix'] = $table_prefix;
 105  wp_set_wpdb_vars();
 106  
 107  // Start the WordPress object cache, or an external object cache if the drop-in is present.
 108  wp_start_object_cache();
 109  
 110  // Attach the default filters.
 111  require( ABSPATH . WPINC . '/default-filters.php' );
 112  
 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 );
 121  }
 122  
 123  register_shutdown_function( 'shutdown_action_hook' );
 124  
 125  // Stop most of WordPress from being loaded if we just want the basics.
 126  if ( SHORTINIT )
 127      return false;
 128  
 129  // Load the L10n library.
 130  require_once( ABSPATH . WPINC . '/l10n.php' );
 131  
 132  // Run the installer if WordPress is not installed.
 133  wp_not_installed();
 134  
 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' );
 214  
 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' );
 220  }
 221  
 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();
 225  
 226  $GLOBALS['wp_plugin_paths'] = array();
 227  
 228  // Load must-use plugins.
 229  foreach ( wp_get_mu_plugins() as $mu_plugin ) {
 230      include_once( $mu_plugin );
 231  }
 232  unset( $mu_plugin );
 233  
 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 );
 239      }
 240      unset( $network_plugin );
 241  }
 242  
 243  /**
 244   * Fires once all must-use and network-activated plugins have loaded.
 245   *
 246   * @since 2.8.0
 247   */
 248  do_action( 'muplugins_loaded' );
 249  
 250  if ( is_multisite() )
 251      ms_cookie_constants(  );
 252  
 253  // Define constants after multisite is loaded.
 254  wp_cookie_constants();
 255  
 256  // Define and enforce our SSL constants
 257  wp_ssl_constants();
 258  
 259  // Create common globals.
 260  require( ABSPATH . WPINC . '/vars.php' );
 261  
 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();
 266  
 267  // Register the default theme directory root
 268  register_theme_directory( get_theme_root() );
 269  
 270  // Load active plugins.
 271  foreach ( wp_get_active_and_valid_plugins() as $plugin ) {
 272      wp_register_plugin_realpath( $plugin );
 273      include_once( $plugin );
 274  }
 275  unset( $plugin );
 276  
 277  // Load pluggable functions.
 278  require ( ABSPATH . WPINC . '/pluggable.php' );
 279  require( ABSPATH . WPINC . '/pluggable-deprecated.php' );
 280  
 281  // Set internal encoding.
 282  wp_set_internal_encoding();
 283  
 284  // Run wp_cache_postload() if object cache is enabled and the function exists.
 285  if ( WP_CACHE && function_exists( 'wp_cache_postload' ) )
 286      wp_cache_postload();
 287  
 288  /**
 289   * Fires once activated plugins have loaded.
 290   *
 291   * Pluggable functions are also available at this point in the loading order.
 292   *
 293   * @since 1.5.0
 294   */
 295  do_action( 'plugins_loaded' );
 296  
 297  // Define constants which affect functionality if not already defined.
 298  wp_functionality_constants();
 299  
 300  // Add magic quotes and set up $_REQUEST ( $_GET + $_POST )
 301  wp_magic_quotes();
 302  
 303  /**
 304   * Fires when comment cookies are sanitized.
 305   *
 306   * @since 2.0.11
 307   */
 308  do_action( 'sanitize_comment_cookies' );
 309  
 310  /**
 311   * WordPress Query object
 312   * @global WP_Query $wp_the_query
 313   * @since 2.0.0
 314   */
 315  $GLOBALS['wp_the_query'] = new WP_Query();
 316  
 317  /**
 318   * Holds the reference to @see $wp_the_query
 319   * Use this global for WordPress queries
 320   * @global WP_Query $wp_query
 321   * @since 1.5.0
 322   */
 323  $GLOBALS['wp_query'] = $GLOBALS['wp_the_query'];
 324  
 325  /**
 326   * Holds the WordPress Rewrite object for creating pretty URLs
 327   * @global WP_Rewrite $wp_rewrite
 328   * @since 1.5.0
 329   */
 330  $GLOBALS['wp_rewrite'] = new WP_Rewrite();
 331  
 332  /**
 333   * WordPress Object
 334   * @global WP $wp
 335   * @since 2.0.0
 336   */
 337  $GLOBALS['wp'] = new WP();
 338  
 339  /**
 340   * WordPress Widget Factory Object
 341   * @global WP_Widget_Factory $wp_widget_factory
 342   * @since 2.8.0
 343   */
 344  $GLOBALS['wp_widget_factory'] = new WP_Widget_Factory();
 345  
 346  /**
 347   * WordPress User Roles
 348   * @global WP_Roles $wp_roles
 349   * @since 2.0.0
 350   */
 351  $GLOBALS['wp_roles'] = new WP_Roles();
 352  
 353  /**
 354   * Fires before the theme is loaded.
 355   *
 356   * @since 2.6.0
 357   */
 358  do_action( 'setup_theme' );
 359  
 360  // Define the template related constants.
 361  wp_templating_constants(  );
 362  
 363  // Load the default text localization domain.
 364  load_default_textdomain();
 365  
 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 );
 371  
 372  // Pull in locale data after loading text domain.
 373  require_once( ABSPATH . WPINC . '/locale.php' );
 374  
 375  /**
 376   * WordPress Locale object for loading locale domain date and various strings.
 377   * @global WP_Locale $wp_locale
 378   * @since 2.1.0
 379   */
 380  $GLOBALS['wp_locale'] = new WP_Locale();
 381  
 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' );
 388  }
 389  
 390  /**
 391   * Fires after the theme is loaded.
 392   *
 393   * @since 3.0.0
 394   */
 395  do_action( 'after_setup_theme' );
 396  
 397  // Set up current user.
 398  $GLOBALS['wp']->init();
 399  
 400  /**
 401   * Fires after WordPress has finished loading but before any headers are sent.
 402   *
 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.).
 406   *
 407   * If you wish to plug an action once WP is loaded, use the {@see 'wp_loaded'} hook below.
 408   *
 409   * @since 1.5.0
 410   */
 411  do_action( 'init' );
 412  
 413  // Check site status
 414  if ( is_multisite() ) {
 415      if ( true !== ( $file = ms_site_check() ) ) {
 416          require( $file );
 417          die();
 418      }
 419      unset($file);
 420  }
 421  
 422  /**
 423   * This hook is fired once WP, all plugins, and the theme are fully loaded and instantiated.
 424   *
 425   * Ajax requests should use wp-admin/admin-ajax.php. admin-ajax.php can handle requests for
 426   * users not logged in.
 427   *
 428   * @link https://codex.wordpress.org/AJAX_in_Plugins
 429   *
 430   * @since 3.0.0
 431   */
 432  do_action( 'wp_loaded' );

title

Description

title

Description

title

Description

title

title

Body