• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「関数リファレンス/wp safe redirect」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/wp_safe_redirect 03:24, 17 June 2015 Sbruner 版を反映して残りを和訳。)
 
(他の1人の利用者による、間の1版が非表示)
1行目: 1行目:
{{NeedTrans|一部}}
+
<div id="Description">
 +
== 説明 ==
 +
</div>
  
== 概要 ==
+
[[関数リファレンス/wp_redirect|wp_redirect()]] を使って、安全な(ローカル)リダイレクトを実行します。
  
Performs a safe (local) redirect, using wp_redirect().
+
$location が絶対パスなら、許可されたホストを使っているかチェックします。そのため許可されたホストの追加や削除をプラグインから行えます。
  
Checks whether the $location is using an allowed host, if it has an absolute path. A plugin can therefore set or remove allowed host(s) to or from the list.
+
ホストが許可されていなければ、代わりに wp-admin または siteurl へリダイレクトされます。これにより悪意のある別のホストへのリダイレクトを回避しますが、これを使うことはあまりないでしょう。<!-- but only used in a few places. -->
 
+
If the host is not allowed, then the redirect is to wp-admin on the siteurl instead. This prevents malicious redirects which redirect to another host, but only used in a few places.
+
  
 +
<div id="Usage">
 
== 使い方 ==
 
== 使い方 ==
 +
</div>
  
<?php wp_safe_redirect( $location, $status ); ?>
+
wp_safe_redirect() は自動的に exit しないので、直後に exit を実行すべきです。<!-- should almost always be followed by exit. -->
 +
<pre><?php
 +
wp_safe_redirect( $location, $status );
 +
exit;
 +
?></pre>
  
 +
<div id="Parameters">
 
== パラメータ ==
 
== パラメータ ==
 +
</div>
  
{{Parameter|$location|string||required}}
+
{{Parameter|$location|文字列|リダイレクト先 URL}}
  
{{Parameter|$status|integer||optional|302}}
+
{{Parameter|$status|整数|HTTP レスポンスコード|オプション|302}}
  
== 返り値 ==
+
<div id="Return Values">
 +
== 戻り値 ==
 +
</div>
  
{{Return||void|Does not return anything}}
+
{{Return||void|何も返しません。}}
  
== 更新履歴 ==
+
<div id="Change Log">
 +
== 変更履歴 ==
 +
</div>
  
導入: [[Version 2.3|2.3]]
+
新規導入: [[Version 2.3|2.3]]
  
 +
<div id="Source File">
 
== ソースファイル ==
 
== ソースファイル ==
 +
</div>
  
<tt>wp_safe_redirect()</tt> は {{Trac|wp-includes/pluggable.php}}にあります。
+
<tt>wp_safe_redirect()</tt> は {{Trac|wp-includes/pluggable.php}} にあります。
  
==関連==
+
<div id="Related">
 +
== 関連項目 ==
 +
</div>
  
* See Also:
+
* [[プラグイン API/フィルターフック一覧/wp_redirect|wp_redirect (フィルター)]] /[[:en:Plugin_API/Filter_Reference/wp_redirect|en]]
[[関数リファレンス/wp_safe_redirect|wp_safe_redirect()]] /[[:en:Function_Reference/wp_safe_redirect|en]]
+
* [[プラグイン API/フィルターフック一覧/wp_redirect_status|wp_redirect_status (フィルター)]] /[[:en:Plugin_API/Filter_Reference/wp_redirect_status|en]]
[[Plugin_API/Filter_Reference/wp_redirect|wp_redirect (filter)]] /[[:en:Plugin_API/Filter_Reference/wp_redirect|en]]
+
* [[プラガブル関数]]
[[Plugin_API/Filter_Reference/wp_redirect_status|wp_redirect_status (filter)]] /[[:en:Plugin_API/Filter_Reference/wp_redirect_status|en]]
+
* [[関数リファレンス/wp_die|wp_die()]]
[[Pluggable Functions|Pluggable Functions]] /[[:en:Pluggable Functions|en]]
+
[[関数リファレンス/wp_die|wp_die()]] /[[:en:Function_Reference/wp_die|en]]
+
  
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{原文|Function Reference/wp_safe_redirect|151540}}<!-- 13:08, 12 May 2015‎ Miccweb  版 -->
+
{{原文|Function Reference/wp_safe_redirect|152305}} <!-- 03:24, 17 June 2015 Sbruner 版 -->
  
 +
{{DEFAULTSORT:Wp_safe_redirect}}
 +
[[Category:関数]]
 
[[Category:プラガブル関数]]
 
[[Category:プラガブル関数]]
 
[[Category:wp2.3]]
 
[[Category:wp2.3]]
 +
 +
[[en:Function Reference/wp_safe_redirect]]
 +
[[it:Riferimento funzioni/wp_safe_redirect]]

2015年11月14日 (土) 14:21時点における最新版

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 にあります。


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


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