関数リファレンス/wp safe redirect

説明

wp_redirect() を使って、安全な（ローカル）リダイレクトを実行します。

$location が絶対パスなら、許可されたホストを使っているかチェックします。そのため許可されたホストの追加や削除をプラグインから行えます。

ホストが許可されていなければ、代わりに wp-admin または siteurl へリダイレクトされます。これにより悪意のある別のホストへのリダイレクトを回避しますが、これを使うことはあまりないでしょう。

使い方

wp_safe_redirect() は自動的に exit しないので、直後に exit を実行すべきです。

<?php
wp_safe_redirect( $location, $status );
exit;
?>

パラメータ

$location

（文字列） （必須） リダイレクト先 URL

初期値： なし

$status

（整数） （オプション） HTTP レスポンスコード

初期値： 302

戻り値

(void) 

何も返しません。

変更履歴

新規導入: 2.3

ソースファイル

wp_safe_redirect() は wp-includes/pluggable.php にあります。

関連項目

• wp_redirect (フィルター) /en
• wp_redirect_status (フィルター) /en
• プラガブル関数
• wp_die()

関数リファレンス、テンプレートタグ目次もご覧ください。

最新英語版： WordPress Codex » Function Reference/wp_safe_redirect （最新版との差分）