delete_transient() の使い方|説明・引数・注意点

説明

delete_transient() は、トランジェントを削除する関数です。

基本構文

delete_transient( string $transient ): bool

引数

  • $transient:トランジェント名

戻り値

削除できたら true。

使い方(サンプル)

delete_transient( 'my_api_cache' );

注意点

  • キャッシュの手動クリアに使います。

実務での使いどころ

  • 元のデータを更新したときに、キャッシュを消して、作り直させるとき。
  • 保存した値を、手動で無効にするとき。

よくあるミスと対処

  • 存在しない名前の削除では、false が返る。
  • 元のデータを更新しても、キャッシュを消さず、古い値が使われ続ける。save_post などで削除する。

NG例

update_option( 'my_source', $new ); // キャッシュが残り、古い値が使われる

OK例

update_option( 'my_source', $new );
delete_transient( 'my_data' );

使い分け早見表

関数 役割
delete_transient() 削除する
set_transient() 有効期限つきで保存する
get_transient() 保存した値を取得する

関連項目

get_transient()、set_transient()

公式リファレンス:delete_transient() | Function | WordPress Developer Resources

コメント

タイトルとURLをコピーしました