| @@ -14,13 +14,12 @@ | ||
| 14 | 14 | /** |
| 15 | 15 | * Trait Get_Instance. |
| 16 | 16 | */ |
| 17 | 17 | trait Get_Instance { |
| 18 | - | |
| 19 | 18 | /** |
| 20 | 19 | * Instance object. |
| 21 | 20 | * |
| 22 | - * @var self Class Instance. | |
| 21 | + * @var self|null Class Instance. | |
| 23 | 22 | */ |
| 24 | 23 | private static $instance = null; |
| 25 | 24 | |
| 26 | 25 | /** |
| @@ -33,6 +32,21 @@ | ||
| 33 | 32 | if ( null === self::$instance ) { |
| 34 | 33 | self::$instance = new self(); |
| 35 | 34 | } |
| 36 | 35 | return self::$instance; |
| 36 | + } | |
| 37 | + | |
| 38 | + /** | |
| 39 | + * Reset the cached instance. | |
| 40 | + * | |
| 41 | + * Primarily for tests, which need to re-resolve a singleton after changing | |
| 42 | + * the environment it reads at construction time (e.g. activating a | |
| 43 | + * multilingual provider via a filter). The next get_instance() call rebuilds | |
| 44 | + * the object. | |
| 45 | + * | |
| 46 | + * @since 2.11.0 | |
| 47 | + * @return void | |
| 48 | + */ | |
| 49 | + public static function reset_instance() { | |
| 50 | + self::$instance = null; | |
| 37 | 51 | } |
| 38 | 52 | } |