diff options
Diffstat (limited to 'wp-includes/default-constants.php')
| -rw-r--r-- | wp-includes/default-constants.php | 436 |
1 files changed, 436 insertions, 0 deletions
diff --git a/wp-includes/default-constants.php b/wp-includes/default-constants.php new file mode 100644 index 0000000..5bccc20 --- /dev/null +++ b/wp-includes/default-constants.php @@ -0,0 +1,436 @@ +<?php +/** + * Defines constants and global variables that can be overridden, generally in wp-config.php. + * + * @package WordPress + */ + +/** + * Defines initial WordPress constants. + * + * @see wp_debug_mode() + * + * @since 3.0.0 + * + * @global int $blog_id The current site ID. + * @global string $wp_version The WordPress version string. + */ +function wp_initial_constants() { + global $blog_id, $wp_version; + + /**#@+ + * Constants for expressing human-readable data sizes in their respective number of bytes. + * + * @since 4.4.0 + * @since 6.0.0 `PB_IN_BYTES`, `EB_IN_BYTES`, `ZB_IN_BYTES`, and `YB_IN_BYTES` were added. + */ + define( 'KB_IN_BYTES', 1024 ); + define( 'MB_IN_BYTES', 1024 * KB_IN_BYTES ); + define( 'GB_IN_BYTES', 1024 * MB_IN_BYTES ); + define( 'TB_IN_BYTES', 1024 * GB_IN_BYTES ); + define( 'PB_IN_BYTES', 1024 * TB_IN_BYTES ); + define( 'EB_IN_BYTES', 1024 * PB_IN_BYTES ); + define( 'ZB_IN_BYTES', 1024 * EB_IN_BYTES ); + define( 'YB_IN_BYTES', 1024 * ZB_IN_BYTES ); + /**#@-*/ + + // Start of run timestamp. + if ( ! defined( 'WP_START_TIMESTAMP' ) ) { + define( 'WP_START_TIMESTAMP', microtime( true ) ); + } + + $current_limit = ini_get( 'memory_limit' ); + $current_limit_int = wp_convert_hr_to_bytes( $current_limit ); + + // Define memory limits. + if ( ! defined( 'WP_MEMORY_LIMIT' ) ) { + if ( false === wp_is_ini_value_changeable( 'memory_limit' ) ) { + define( 'WP_MEMORY_LIMIT', $current_limit ); + } elseif ( is_multisite() ) { + define( 'WP_MEMORY_LIMIT', '64M' ); + } else { + define( 'WP_MEMORY_LIMIT', '40M' ); + } + } + + if ( ! defined( 'WP_MAX_MEMORY_LIMIT' ) ) { + if ( false === wp_is_ini_value_changeable( 'memory_limit' ) ) { + define( 'WP_MAX_MEMORY_LIMIT', $current_limit ); + } elseif ( -1 === $current_limit_int || $current_limit_int > 268435456 /* = 256M */ ) { + define( 'WP_MAX_MEMORY_LIMIT', $current_limit ); + } else { + define( 'WP_MAX_MEMORY_LIMIT', '256M' ); + } + } + + // Set memory limits. + $wp_limit_int = wp_convert_hr_to_bytes( WP_MEMORY_LIMIT ); + if ( -1 !== $current_limit_int && ( -1 === $wp_limit_int || $wp_limit_int > $current_limit_int ) ) { + ini_set( 'memory_limit', WP_MEMORY_LIMIT ); + } + + if ( ! isset( $blog_id ) ) { + $blog_id = 1; + } + + if ( ! defined( 'WP_CONTENT_DIR' ) ) { + define( 'WP_CONTENT_DIR', ABSPATH . 'wp-content' ); // No trailing slash, full paths only - WP_CONTENT_URL is defined further down. + } + + /* + * Add define( 'WP_DEVELOPMENT_MODE', 'core' ), or define( 'WP_DEVELOPMENT_MODE', 'plugin' ), or + * define( 'WP_DEVELOPMENT_MODE', 'theme' ), or define( 'WP_DEVELOPMENT_MODE', 'all' ) to wp-config.php + * to signify development mode for WordPress core, a plugin, a theme, or all three types respectively. + */ + if ( ! defined( 'WP_DEVELOPMENT_MODE' ) ) { + define( 'WP_DEVELOPMENT_MODE', '' ); + } + + // Add define( 'WP_DEBUG', true ); to wp-config.php to enable display of notices during development. + if ( ! defined( 'WP_DEBUG' ) ) { + if ( wp_get_development_mode() || 'development' === wp_get_environment_type() ) { + define( 'WP_DEBUG', true ); + } else { + define( 'WP_DEBUG', false ); + } + } + + /* + * Add define( 'WP_DEBUG_DISPLAY', null ); to wp-config.php to use the globally configured setting + * for 'display_errors' and not force errors to be displayed. Use false to force 'display_errors' off. + */ + if ( ! defined( 'WP_DEBUG_DISPLAY' ) ) { + define( 'WP_DEBUG_DISPLAY', true ); + } + + // Add define( 'WP_DEBUG_LOG', true ); to enable error logging to wp-content/debug.log. + if ( ! defined( 'WP_DEBUG_LOG' ) ) { + define( 'WP_DEBUG_LOG', false ); + } + + if ( ! defined( 'WP_CACHE' ) ) { + define( 'WP_CACHE', false ); + } + + /* + * Add define( 'SCRIPT_DEBUG', true ); to wp-config.php to enable loading of non-minified, + * non-concatenated scripts and stylesheets. + */ + if ( ! defined( 'SCRIPT_DEBUG' ) ) { + if ( ! empty( $wp_version ) ) { + $develop_src = str_contains( $wp_version, '-src' ); + } else { + $develop_src = false; + } + + define( 'SCRIPT_DEBUG', $develop_src ); + } + + /** + * Private + */ + if ( ! defined( 'MEDIA_TRASH' ) ) { + define( 'MEDIA_TRASH', false ); + } + + if ( ! defined( 'SHORTINIT' ) ) { + define( 'SHORTINIT', false ); + } + + // Constants for features added to WP that should short-circuit their plugin implementations. + define( 'WP_FEATURE_BETTER_PASSWORDS', true ); + + /**#@+ + * Constants for expressing human-readable intervals + * in their respective number of seconds. + * + * Please note that these values are approximate and are provided for convenience. + * For example, MONTH_IN_SECONDS wrongly assumes every month has 30 days and + * YEAR_IN_SECONDS does not take leap years into account. + * + * If you need more accuracy please consider using the DateTime class (https://www.php.net/manual/en/class.datetime.php). + * + * @since 3.5.0 + * @since 4.4.0 Introduced `MONTH_IN_SECONDS`. + */ + define( 'MINUTE_IN_SECONDS', 60 ); + define( 'HOUR_IN_SECONDS', 60 * MINUTE_IN_SECONDS ); + define( 'DAY_IN_SECONDS', 24 * HOUR_IN_SECONDS ); + define( 'WEEK_IN_SECONDS', 7 * DAY_IN_SECONDS ); + define( 'MONTH_IN_SECONDS', 30 * DAY_IN_SECONDS ); + define( 'YEAR_IN_SECONDS', 365 * DAY_IN_SECONDS ); + /**#@-*/ +} + +/** + * Defines plugin directory WordPress constants. + * + * Defines must-use plugin directory constants, which may be overridden in the sunrise.php drop-in. + * + * @since 3.0.0 + */ +function wp_plugin_directory_constants() { + if ( ! defined( 'WP_CONTENT_URL' ) ) { + define( 'WP_CONTENT_URL', get_option( 'siteurl' ) . '/wp-content' ); // Full URL - WP_CONTENT_DIR is defined further up. + } + + /** + * Allows for the plugins directory to be moved from the default location. + * + * @since 2.6.0 + */ + if ( ! defined( 'WP_PLUGIN_DIR' ) ) { + define( 'WP_PLUGIN_DIR', WP_CONTENT_DIR . '/plugins' ); // Full path, no trailing slash. + } + + /** + * Allows for the plugins directory to be moved from the default location. + * + * @since 2.6.0 + */ + if ( ! defined( 'WP_PLUGIN_URL' ) ) { + define( 'WP_PLUGIN_URL', WP_CONTENT_URL . '/plugins' ); // Full URL, no trailing slash. + } + + /** + * Allows for the plugins directory to be moved from the default location. + * + * @since 2.1.0 + * @deprecated + */ + if ( ! defined( 'PLUGINDIR' ) ) { + define( 'PLUGINDIR', 'wp-content/plugins' ); // Relative to ABSPATH. For back compat. + } + + /** + * Allows for the mu-plugins directory to be moved from the default location. + * + * @since 2.8.0 + */ + if ( ! defined( 'WPMU_PLUGIN_DIR' ) ) { + define( 'WPMU_PLUGIN_DIR', WP_CONTENT_DIR . '/mu-plugins' ); // Full path, no trailing slash. + } + + /** + * Allows for the mu-plugins directory to be moved from the default location. + * + * @since 2.8.0 + */ + if ( ! defined( 'WPMU_PLUGIN_URL' ) ) { + define( 'WPMU_PLUGIN_URL', WP_CONTENT_URL . '/mu-plugins' ); // Full URL, no trailing slash. + } + + /** + * Allows for the mu-plugins directory to be moved from the default location. + * + * @since 2.8.0 + * @deprecated + */ + if ( ! defined( 'MUPLUGINDIR' ) ) { + define( 'MUPLUGINDIR', 'wp-content/mu-plugins' ); // Relative to ABSPATH. For back compat. + } +} + +/** + * Defines cookie-related WordPress constants. + * + * Defines constants after multisite is loaded. + * + * @since 3.0.0 + */ +function wp_cookie_constants() { + /** + * Used to guarantee unique hash cookies. + * + * @since 1.5.0 + */ + if ( ! defined( 'COOKIEHASH' ) ) { + $siteurl = get_site_option( 'siteurl' ); + if ( $siteurl ) { + define( 'COOKIEHASH', md5( $siteurl ) ); + } else { + define( 'COOKIEHASH', '' ); + } + } + + /** + * @since 2.0.0 + */ + if ( ! defined( 'USER_COOKIE' ) ) { + define( 'USER_COOKIE', 'wordpressuser_' . COOKIEHASH ); + } + + /** + * @since 2.0.0 + */ + if ( ! defined( 'PASS_COOKIE' ) ) { + define( 'PASS_COOKIE', 'wordpresspass_' . COOKIEHASH ); + } + + /** + * @since 2.5.0 + */ + if ( ! defined( 'AUTH_COOKIE' ) ) { + define( 'AUTH_COOKIE', 'wordpress_' . COOKIEHASH ); + } + + /** + * @since 2.6.0 + */ + if ( ! defined( 'SECURE_AUTH_COOKIE' ) ) { + define( 'SECURE_AUTH_COOKIE', 'wordpress_sec_' . COOKIEHASH ); + } + + /** + * @since 2.6.0 + */ + if ( ! defined( 'LOGGED_IN_COOKIE' ) ) { + define( 'LOGGED_IN_COOKIE', 'wordpress_logged_in_' . COOKIEHASH ); + } + + /** + * @since 2.3.0 + */ + if ( ! defined( 'TEST_COOKIE' ) ) { + define( 'TEST_COOKIE', 'wordpress_test_cookie' ); + } + + /** + * @since 1.2.0 + */ + if ( ! defined( 'COOKIEPATH' ) ) { + define( 'COOKIEPATH', preg_replace( '|https?://[^/]+|i', '', get_option( 'home' ) . '/' ) ); + } + + /** + * @since 1.5.0 + */ + if ( ! defined( 'SITECOOKIEPATH' ) ) { + define( 'SITECOOKIEPATH', preg_replace( '|https?://[^/]+|i', '', get_option( 'siteurl' ) . '/' ) ); + } + + /** + * @since 2.6.0 + */ + if ( ! defined( 'ADMIN_COOKIE_PATH' ) ) { + define( 'ADMIN_COOKIE_PATH', SITECOOKIEPATH . 'wp-admin' ); + } + + /** + * @since 2.6.0 + */ + if ( ! defined( 'PLUGINS_COOKIE_PATH' ) ) { + define( 'PLUGINS_COOKIE_PATH', preg_replace( '|https?://[^/]+|i', '', WP_PLUGIN_URL ) ); + } + + /** + * @since 2.0.0 + */ + if ( ! defined( 'COOKIE_DOMAIN' ) ) { + define( 'COOKIE_DOMAIN', false ); + } + + if ( ! defined( 'RECOVERY_MODE_COOKIE' ) ) { + /** + * @since 5.2.0 + */ + define( 'RECOVERY_MODE_COOKIE', 'wordpress_rec_' . COOKIEHASH ); + } +} + +/** + * Defines SSL-related WordPress constants. + * + * @since 3.0.0 + */ +function wp_ssl_constants() { + /** + * @since 2.6.0 + */ + if ( ! defined( 'FORCE_SSL_ADMIN' ) ) { + if ( 'https' === parse_url( get_option( 'siteurl' ), PHP_URL_SCHEME ) ) { + define( 'FORCE_SSL_ADMIN', true ); + } else { + define( 'FORCE_SSL_ADMIN', false ); + } + } + force_ssl_admin( FORCE_SSL_ADMIN ); + + /** + * @since 2.6.0 + * @deprecated 4.0.0 + */ + if ( defined( 'FORCE_SSL_LOGIN' ) && FORCE_SSL_LOGIN ) { + force_ssl_admin( true ); + } +} + +/** + * Defines functionality-related WordPress constants. + * + * @since 3.0.0 + */ +function wp_functionality_constants() { + /** + * @since 2.5.0 + */ + if ( ! defined( 'AUTOSAVE_INTERVAL' ) ) { + define( 'AUTOSAVE_INTERVAL', MINUTE_IN_SECONDS ); + } + + /** + * @since 2.9.0 + */ + if ( ! defined( 'EMPTY_TRASH_DAYS' ) ) { + define( 'EMPTY_TRASH_DAYS', 30 ); + } + + if ( ! defined( 'WP_POST_REVISIONS' ) ) { + define( 'WP_POST_REVISIONS', true ); + } + + /** + * @since 3.3.0 + */ + if ( ! defined( 'WP_CRON_LOCK_TIMEOUT' ) ) { + define( 'WP_CRON_LOCK_TIMEOUT', MINUTE_IN_SECONDS ); + } +} + +/** + * Defines templating-related WordPress constants. + * + * @since 3.0.0 + */ +function wp_templating_constants() { + /** + * Filesystem path to the current active template directory. + * + * @since 1.5.0 + * @deprecated 6.4.0 Use get_template_directory() instead. + * @see get_template_directory() + */ + define( 'TEMPLATEPATH', get_template_directory() ); + + /** + * Filesystem path to the current active template stylesheet directory. + * + * @since 2.1.0 + * @deprecated 6.4.0 Use get_stylesheet_directory() instead. + * @see get_stylesheet_directory() + */ + define( 'STYLESHEETPATH', get_stylesheet_directory() ); + + /** + * Slug of the default theme for this installation. + * Used as the default theme when installing new sites. + * It will be used as the fallback if the active theme doesn't exist. + * + * @since 3.0.0 + * + * @see WP_Theme::get_core_default_theme() + */ + if ( ! defined( 'WP_DEFAULT_THEME' ) ) { + define( 'WP_DEFAULT_THEME', 'twentytwentyfour' ); + } +} |