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

説明

基本構文

wp_cache_flush(): bool

引数

引数はありません。

戻り値

成功したら true。

使い方（サンプル）

wp_cache_flush();

注意点

• サイト全体のキャッシュが消えるため、負荷が一時的に高まります。使用は最小限にします。

実務での使いどころ

• 移行や、障害対応のあとに、キャッシュを、まとめて消すとき。

よくあるミスと対処

• 頻繁に、呼んでいる。すべてのキャッシュが消え、サイトが、一時的に重くなる。
• 特定のキャッシュだけを消したいのに、使っている。その場合は、wp_cache_delete()。
• 永続的なオブジェクトキャッシュ（Redisなど）を、他のサイトと共有している環境で、他のサイトの分も、消してしまう。

NG例

add_action( 'save_post', function () {
	wp_cache_flush(); // 保存のたびに、すべてのキャッシュが消える
} );

OK例

add_action( 'save_post', function () {
	wp_cache_delete( 'items', 'my_plugin' );
} );

使い分け早見表

関連項目

wp_cache_delete()

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