功能描述

跳转用户到指定的URL，URL 必须是完整的绝对 URL。

使用说明

wp_redirect() 不会自动退出，使用时需要在后面添加退出函数。如下：

wp_redirect( $location, $status );
exit;

参数

返回值

如果 $location 没有设置，返回false，其他情况下不返回任何值

使用示例

wp_redirect( home_url() );
exit;

也可以跳转到外部链接，或使用301永久永久重定向状态码 :

wp_redirect( 'http://www.example.com', 301 );
exit;

注意：

在HTTP1.1中，302是临时重定向状态码，如果需要永久重定向，请使用HTTP 301状态码。

wp_safe_redirect 与 wp_redirect 的区别

wp_safe_redirect 的作用和 wp_redirect 类似，不同的是前者在跳转之前会检查要跳转的 URL 是否为被允许的主机，检查通过后才跳转，如果检查未通过，则该函数会把用户跳转到当前站点的 /wp-admin/ 页面，这样的处理可以防止程序把用户重定向到站外的恶意网址。该函数仅在后台的少数地方使用。

如果需要修改允许 wp_safe_redirect 函数跳转的网址，我们可以通过 allowed_redirect_hosts Hook 来修改。如下：

add_filter( 'allowed_redirect_hosts', function ( $hosts ) {
    $my_hosts = array(
        'blog.example.com',
        'codex.example.com',
    );

    return array_merge( $hosts, $my_hosts );
}; );

相关函数

wp_sanitize_redirect：对跳转 URL 消毒。

wp_validate_redirect： 验证跳转 URL 是否为允许的 URL。