wp_cache_delete() の使い方｜説明・引数・注意点

説明

基本構文

wp_cache_delete( int|string $key, string $group = '' ): bool

引数

• $key：キャッシュキー
• $group：グループ名

戻り値

削除できたら true。

使い方（サンプル）

wp_cache_delete( 'my_key', 'my_group' );

注意点

• データ更新時に、関連するキャッシュを消すために使います。

実務での使いどころ

• 元のデータを更新したときに、そのキャッシュを、消すとき。

よくあるミスと対処

• $group が、保存したときと違い、消えない。
• データを更新したあとに、呼んでいない。古い値が、使われ続ける。
• 全体を消す wp_cache_flush() を、安易に使っている。必要なキーだけを、消す。

NG例

wp_cache_delete( 'items' ); // 保存したときの、グループを指定していない

OK例

update_option( 'my_items', $new );
wp_cache_delete( 'items', 'my_plugin' );

使い分け早見表

関連項目

wp_cache_set()、wp_cache_get()

公式リファレンス：wp_cache_delete() | Function | WordPress Developer Resources