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

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

「関数リファレンス/set transient」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(途中まで訳)
(途中まで訳)
14行目: 14行目:
 
== パラメータ ==
 
== パラメータ ==
  
{{Parameter|$transient|文字列|Transient名。 Expected to not be SQL-escaped. Should be  45 characters or less in length as WordPress will prefix your name with "_transient_" or "_transient_timeout_" in the options table (depending on whether it expires or not). Longer key names will silently fail.  [http://core.trac.wordpress.org/ticket/15058 Trac #15058]を参照。}}
+
{{Parameter|$transient|文字列|Transient名。 Expected to not be SQL-escaped. Should be  45 characters or less in length as WordPress will prefix your name with "_transient_" or "_transient_timeout_" in the options table (depending on whether it expires or not). 長いキー名はサイレント状態で失敗します。 [http://core.trac.wordpress.org/ticket/15058 Trac #15058]を参照。}}
{{Parameter|$value|mixed|Transientの値。 Expected to not be SQL-escaped.}}
+
{{Parameter|$value|mixed|Transientの値。SQLエスケープではないと予想。}}
{{Parameter|$expiration|int|Time until expiration in seconds from now, or 0 for never expires. Ex: For one day, the expiration value would be: ''(60 * 60 * 24)''.|optional|''0''}}.
+
{{Parameter|$expiration|int|Time until expiration in seconds from now, or 0 for never expires. :一日の場合、有効期限の値は次のようになります。: ''(60 * 60 * 24)''.|オプション|''0''}}.
  
 
== 戻り値 ==
 
== 戻り値 ==
  
; (boolean) :  値がセットしない場合は falseを、値がセットする場合には true を返します。
+
; (真または偽) :  値がセットしない場合は falseを、値がセットする場合には true を返します。
  
 
== 用例 ==
 
== 用例 ==
32行目: 32行目:
  
 
== 注 ==
 
== 注 ==
If a transient exists, this function will update the transient's expiration time.
+
トランジェントが存在する場合、この関数は、トランジェントの有効期限を更新します。
  
 
NB: transients that never expire are autoloaded, whereas transients with an expiration time are not autoloaded. Consider this when adding transients that may not be needed on every page, and thus do not need to be autoloaded, impacting page performance.
 
NB: transients that never expire are autoloaded, whereas transients with an expiration time are not autoloaded. Consider this when adding transients that may not be needed on every page, and thus do not need to be autoloaded, impacting page performance.
  
WordPress provides some constants for specifying time in seconds.  Instead of multiplying out integers, see [[Transients_API#Using_Time_Constants]].
+
WordPressは時間を秒単位で指定するためのいくつかの定数を提供します。代わりに整数を乗算する、次を参照 [[Transients_API#Using_Time_Constants]]
  
Transient key names are limited to 64 characters due to the database settings in the wp_options table ( option_name: varchar(64) ).
+
トランジェントキー名がwp_optionsテーブル内のデータベースの設定において64文字に制限されています( option_name: varchar(64) ).
  
 
== 更新履歴 ==
 
== 更新履歴 ==

2015年7月1日 (水) 17:48時点における版

このページ「関数リファレンス/set transient」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

説明

transientの値をデータベースに保存、更新します。

値をシリアル化する必要は無く、値がセットされる前にシリアライズされます。

使い方

<?php set_transient( $transient, $value, $expiration ); ?>

パラメータ

$transient
文字列) (必須) Transient名。 Expected to not be SQL-escaped. Should be 45 characters or less in length as WordPress will prefix your name with "_transient_" or "_transient_timeout_" in the options table (depending on whether it expires or not). 長いキー名はサイレント状態で失敗します。 Trac #15058を参照。
初期値: なし
$value
mixed) (必須) Transientの値。SQLエスケープではないと予想。
初期値: なし
$expiration
int) (オプション) Time until expiration in seconds from now, or 0 for never expires. 例:一日の場合、有効期限の値は次のようになります。: (60 * 60 * 24).
初期値: 0.

戻り値

(真または偽) 
値がセットしない場合は falseを、値がセットする場合には true を返します。

用例

12時間 $special_query_results オブジェクトを保存する

<?php
set_transient( 'special_query_results', $special_query_results, 12 * HOUR_IN_SECONDS );
?>

トランジェントが存在する場合、この関数は、トランジェントの有効期限を更新します。

NB: transients that never expire are autoloaded, whereas transients with an expiration time are not autoloaded. Consider this when adding transients that may not be needed on every page, and thus do not need to be autoloaded, impacting page performance.

WordPressは時間を秒単位で指定するためのいくつかの定数を提供します。代わりに整数を乗算する、次を参照 Transients_API#Using_Time_Constants

トランジェントキー名がwp_optionsテーブル内のデータベースの設定において64文字に制限されています( option_name: varchar(64) ).

更新履歴

新規導入: 2.8

ソースファイル

set_transient()wp-includes/option.phpにあります。

関連

Transients API: set_transient(), get_transient(), delete_transient(), set_site_transient(), get_site_transient(), delete_site_transient(),


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


最新英語版: WordPress Codex » Function_Reference/set_transient最新版との差分