rest_get_server() WordPress Function
The rest_get_server() function is used to retrieve the current WP_REST_Server instance. This is useful for introspecting the server's state and capabilities, or for adding extra functionality on top of the default REST API.
rest_get_server() #
Retrieves the current REST server instance.
Description
Instantiates a new instance if none exists already.
Return
(WP_REST_Server) REST server instance.
Source
File: wp-includes/rest-api.php
function rest_get_server() { /* @var WP_REST_Server $wp_rest_server */ global $wp_rest_server; if ( empty( $wp_rest_server ) ) { /** * Filters the REST Server Class. * * This filter allows you to adjust the server class used by the REST API, using a * different class to handle requests. * * @since 4.4.0 * * @param string $class_name The name of the server class. Default 'WP_REST_Server'. */ $wp_rest_server_class = apply_filters( 'wp_rest_server_class', 'WP_REST_Server' ); $wp_rest_server = new $wp_rest_server_class; /** * Fires when preparing to serve a REST API request. * * Endpoint objects should be created and register their hooks on this action rather * than another action to ensure they're only loaded when needed. * * @since 4.4.0 * * @param WP_REST_Server $wp_rest_server Server object. */ do_action( 'rest_api_init', $wp_rest_server ); } return $wp_rest_server; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
4.5.0 | Introduced. |