wp_get_environment_type() WordPress Function
The wp_get_environment_type() function is used to get the type of environment WordPress is currently running in.
wp_get_environment_type() #
Retrieves the current environment type.
Description
The type can be set via the WP_ENVIRONMENT_TYPE global system variable, or a constant of the same name.
Possible values are ‘local’, ‘development’, ‘staging’, and ‘production’. If not set, the type defaults to ‘production’.
Return
(string) The current environment type.
More Information
- This function allows plugin and theme authors to more easily differentiate how they handle specific functionality between production and development sites in a standardized way.
- When
developmentis returned by wp_get_environment_type(),WP_DEBUGwill be set totrueif it is not defined in thewp-config.phpfile of the site. - All hosts that support setting up staging environments are requested to set this feature to
stagingon those staging environments. Similarly, all developers with development environments shall set this value todevelopmentappropriately.
Example Usage:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | switch ( wp_get_environment_type() ) { case 'local': case 'development': do_nothing(); break; case 'staging': do_staging_thing(); break; case 'production': default: do_production_thing(); break;} |
Source
File: wp-includes/load.php
191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 | function wp_get_environment_type() { static $current_env = ''; if ( ! defined( 'WP_RUN_CORE_TESTS' ) && $current_env ) { return $current_env; } $wp_environments = array( 'local', 'development', 'staging', 'production', ); // Add a note about the deprecated WP_ENVIRONMENT_TYPES constant. if ( defined( 'WP_ENVIRONMENT_TYPES' ) && function_exists( '_deprecated_argument' ) ) { if ( function_exists( '__' ) ) { /* translators: %s: WP_ENVIRONMENT_TYPES */ $message = sprintf( __( 'The %s constant is no longer supported.' ), 'WP_ENVIRONMENT_TYPES' ); } else { $message = sprintf( 'The %s constant is no longer supported.', 'WP_ENVIRONMENT_TYPES' ); } _deprecated_argument( 'define()', '5.5.1', $message ); } // Check if the environment variable has been set, if `getenv` is available on the system. if ( function_exists( 'getenv' ) ) { $has_env = getenv( 'WP_ENVIRONMENT_TYPE' ); if ( false !== $has_env ) { $current_env = $has_env; } } // Fetch the environment from a constant, this overrides the global system variable. if ( defined( 'WP_ENVIRONMENT_TYPE' ) ) { $current_env = WP_ENVIRONMENT_TYPE; } // Make sure the environment is an allowed one, and not accidentally set to an invalid value. if ( ! in_array( $current_env, $wp_environments, true ) ) { $current_env = 'production'; } return $current_env;} |
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 5.5.1 | Removed the ability to alter the list of types. |
| 5.5.0 | Introduced. |