clean_post_cache

Will clean the post in the cache.

Description

clean_post_cache( (int|WP_Post) $post ); 

Cleaning means delete from the cache of the post. Will call to clean the term object cache associated with the post ID.

This function not run if $_wp_suspend_cache_invalidation is not empty. See wp_suspend_cache_invalidation(…).

Parameters (1)

0. $post (int|WP_Post)
Post ID or post object to remove from the cache.

Usage

  1. if ( !function_exists( 'clean_post_cache' ) ) { 
  2.     require_once ABSPATH . WPINC . '/post.php'; 
  3. } 
  4.   
  5. // Post ID or post object to remove from the cache. 
  6. $post = null; 
  7.   
  8. // NOTICE! Understand what this does before running. 
  9. $result = clean_post_cache($post); 
  10.     

Defined (1)

The function is defined in the following location(s).

/wp-includes/post.php  
  1. function clean_post_cache( $post ) { 
  2.     global $_wp_suspend_cache_invalidation; 
  3.  
  4.     if ( ! empty( $_wp_suspend_cache_invalidation ) ) 
  5.         return; 
  6.  
  7.     $post = get_post( $post ); 
  8.     if ( empty( $post ) ) 
  9.         return; 
  10.  
  11.     wp_cache_delete( $post->ID, 'posts' ); 
  12.     wp_cache_delete( $post->ID, 'post_meta' ); 
  13.  
  14.     clean_object_term_cache( $post->ID, $post->post_type ); 
  15.  
  16.     wp_cache_delete( 'wp_get_archives', 'general' ); 
  17.  
  18.     /** 
  19.      * Fires immediately after the given post's cache is cleaned. 
  20.      * 
  21.      * @since 2.5.0 
  22.      * 
  23.      * @param int     $post_id Post ID. 
  24.      * @param WP_Post $post    Post object. 
  25.      */ 
  26.     do_action( 'clean_post_cache', $post->ID, $post ); 
  27.  
  28.     if ( 'page' == $post->post_type ) { 
  29.         wp_cache_delete( 'all_page_ids', 'posts' ); 
  30.  
  31.         /** 
  32.          * Fires immediately after the given page's cache is cleaned. 
  33.          * 
  34.          * @since 2.5.0 
  35.          * 
  36.          * @param int $post_id Post ID. 
  37.          */ 
  38.         do_action( 'clean_page_cache', $post->ID ); 
  39.     } 
  40.  
  41.     wp_cache_set( 'last_changed', microtime(), 'posts' ); 
  42. }