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

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

関数リファレンス/set transient

提供: WordPress Codex 日本語版
< 関数リファレンス
2015年5月27日 (水) 09:25時点におけるMiccweb (トーク | 投稿記録)による版 (ページ追加)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

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

説明

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

値をシリアル化する必要はありません。

If the value needs to be serialized, then it will be serialized before it is set.

使い方

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

パラメータ

$transient
string) (必須) Transient name. 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. See Trac #15058.
初期値: なし
$value
mixed) (必須) Transient value. Expected to not be SQL-escaped.
初期値: なし
$expiration
int) (optional) Time until expiration in seconds from now, or 0 for never expires. Ex: For one day, the expiration value would be: (60 * 60 * 24).
初期値: 0.

戻り値

(boolean) 
False if value was not set and true if value was set.

用例

Saving the $special_query_results object for 12 hours

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

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.

WordPress provides some constants for specifying time in seconds. Instead of multiplying out integers, see 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) ).

更新履歴

新規導入: 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最新版との差分