説明
bool wp_safe_redirect( string $locaution [ , int $status = 302 [ , string $x_redirect_by = 'WordPress' ] ] )
指定されたURLが有効か調べ、リダイレクトする。
パラメータ
- $locautionリダイレクト先のURLを指定。
- $statusリダイレクト時のステータスコードを指定（省略時は302）。
- $x_redirect_by[5.1.0]ヘッダーX-Redirect-Byの値を指定（省略時は'WordPress'）。
返り値
[5.1.0より前]返り値はありません。
[5.1.0以降] wp_redirect関数の返り値を返す。
注意
wp_redirect関数はURLの内容を検証しないが、このwp_safe_redirect関数はURLを内容を検証し、無効なURLの場合は admin_url関数で取得できる管理者向けページへリダイレクトする。
使用例
- $urlへリダイレクトする。<?php wp_safe_redirect( $url ); ?>
フィルター
[4.3.0]パラメータ$locautionが無効なURLの場合にリダイレクト先として管理者向けページのURLを確定する前にwp_safe_redirect_fallbackフィルターを呼び出す。パラメータ$admin_urlには admin_url関数で取得した値が、$statusは本関数が受け取った内容が格納される。$location = wp_validate_redirect( $location, apply_filters( 'wp_safe_redirect_fallback', $admin_url, $status ) );
アクション
実行するアクションはありません。ソースファイル
/wp-includes/pluggable.php最終更新 : 2019年03月04日 14:16
関連
お勧め
フィードにサムネイル画像を追加する（2022年11月7日 更新）
WordPressが出力するの標準のフィードには、各投稿のサムネイル画像の情報が含まれていない。ネットで検索してみるといくつかの方法があることがわかったので、その中から2つ試してみた。
ダッシュボードの「クイックドラフト」を「CodeMirror」に変更してみた（2019年11月5日 更新）
管理ページの「テーマエディター」では4.9以降「CodeMirror」が利用されている。今回はこの「CodeMirror」をプラグインで活用できないか調べた話である。
スマートフォン向けの振り分けを自前で行う（2012年1月23日 更新）
PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。ブロックエディターの文字サイズ設定を変えてみる（2019年12月12日 更新）
今回は「前回投稿した内容」の続きブロックエディターの文字サイズ設定を変えようと思う。参考にするテーマはもちろん「Twenty Twenty」である。
5.5の機能強化：コメントフォームのちょっとした改良（2020年8月12日 更新）
来月にリリースされるWordPress 5.5に向けてBeta 1、2、3と公開が続いている。「WordPress 5.5 Beta 3（以降Beta 3）」のソースコードを見ていくと、コメントフォームを表示する comment_form関数が機能拡張されていた。