WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_get_referer()

wp_get_referer(): string|false

In this article

Back to top

Retrieves referer from ‘_wp_http_referer’ or HTTP referer.

Description

If it’s the same as the current request URL, will return false.

Return

string|false Referer URL on success, false on failure.

More Information

HTTP referer is a server variable. ‘referer’ is deliberately misspelled.

If page “refered” (form posted) to itself, returns false (because $_SERVER[‘HTTP_REFERER’] == $_REQUEST[‘_wp_http_referer’])

Source

function wp_get_referer() {
	// Return early if called before wp_validate_redirect() is defined.
	if ( ! function_exists( 'wp_validate_redirect' ) ) {
		return false;
	}

	$ref = wp_get_raw_referer();

	if ( $ref && wp_unslash( $_SERVER['REQUEST_URI'] ) !== $ref
		&& home_url() . wp_unslash( $_SERVER['REQUEST_URI'] ) !== $ref
	) {
		return wp_validate_redirect( $ref, false );
	}

	return false;
}

View all references View on Trac View on GitHub

UsesDescription
wp_get_raw_referer()wp-includes/functions.php

Retrieves unvalidated referer from the ‘_wp_http_referer’ URL query variable or the HTTP referer.

wp_validate_redirect()wp-includes/pluggable.php

Validates a URL for use in a redirect.

wp_unslash()wp-includes/formatting.php

Removes slashes from a string or recursively removes slashes from strings within an array.

home_url()wp-includes/link-template.php

Retrieves the URL for the current site where the front end is accessible.

Show 2 moreShow less
Used byDescription
WP_Recovery_Mode::handle_exit_recovery_mode()wp-includes/class-wp-recovery-mode.php

Handles a request to exit Recovery Mode.

the_block_editor_meta_box_post_form_hidden_fields()wp-admin/includes/post.php

Renders the hidden form required for the meta boxes form.

WP_Customize_Manager::get_return_url()wp-includes/class-wp-customize-manager.php

Gets URL to link the user to when closing the Customizer.

WP_Terms_List_Table::handle_row_actions()wp-admin/includes/class-wp-terms-list-table.php

Generates and displays row action links.

wp_media_attach_action()wp-admin/includes/media.php

Encapsulates the logic for Attach/Detach actions.

set_screen_options()wp-admin/includes/misc.php

Saves option for number of rows when listing posts, pages, comments, etc.

_admin_notice_post_locked()wp-admin/includes/post.php

Outputs the HTML for the notice to say that someone else is editing or has taken over editing of this post.

WP_Terms_List_Table::column_name()wp-admin/includes/class-wp-terms-list-table.php
redirect_post()wp-admin/includes/post.php

Redirects to previous page.

auth_redirect()wp-includes/pluggable.php

Checks if a user is logged in, if not it redirects them to the login page.

check_admin_referer()wp-includes/pluggable.php

Ensures intent by verifying that a user was referred from another admin page with the correct security nonce.

wp_nonce_ays()wp-includes/functions.php

Displays “Are You Sure” message to confirm the action being taken.

wp_original_referer_field()wp-includes/functions.php

Retrieves or displays original referer hidden field for forms.

Show 8 moreShow less

Changelog

VersionDescription
2.0.4Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.