1: <?php
  2: 
  3: /**
  4:  * Delete value from cache.
  5:  *
  6:  * @param  mixed  $key   The cache key, can be anything if `$md5` is set to true.
  7:  * @param  string $group The cache group. Optional.
  8:  *
  9:  * @return bool
 10:  */
 11: function xu_cache_delete( $key, $group = '' ) {
 12:     // Check for empty key.
 13:     if ( empty( $key ) ) {
 14:         return false;
 15:     }
 16: 
 17:     if ( is_array( $key ) || is_object( $key ) ) {
 18:         $key = md5( serialize( $key ) );
 19:     }
 20: 
 21:     if ( ! is_string( $key ) ) {
 22:         return false;
 23:     }
 24: 
 25:     return wp_cache_delete( $key, $group );
 26: }
 27: 
 28: /**
 29:  * Removes cache contents for a given group.
 30:  *
 31:  * @codeCoverageIgnore
 32:  *
 33:  * @param  string $group  The cache group.
 34:  * @param  string $suffix The suffix. Optional.
 35:  *
 36:  * @return bool
 37:  */
 38: function xu_cache_delete_group( $group, $suffix = '' ) {
 39:     if ( ! function_exists( 'wp_cache_delete_group' ) ) {
 40:         return false;
 41:     }
 42: 
 43:     return wp_cache_delete_group( xu_cache_key( $group, $suffix ) );
 44: }
 45: 
 46: /**
 47:  * Get value from given functions cache or from function
 48:  * if function cache don't exists.
 49:  *
 50:  * @param  string $key   The cache key, will be serialized if array or object.
 51:  * @param  string $fn    The function.
 52:  * @param  array  $args  The function arguments.
 53:  * @param  string $group The cache group. Optional.
 54:  *
 55:  * @return mixed Cached value, function return value or false.
 56:  */
 57: function xu_cache_get( $key, $fn = '', $args = [], $group = '' ) {
 58:     if ( ! empty( $fn ) && ! empty( $args ) && empty( $group ) ) {
 59:         if ( is_string( $args ) ) {
 60:             $group = $args;
 61:         }
 62: 
 63:         $args = $fn;
 64:         $fn   = $key;
 65:         $key  = $args;
 66:     }
 67: 
 68:     if ( is_array( $key ) && count( $key ) === 1 ) {
 69:         $key = $key[0];
 70:     }
 71: 
 72:     if ( is_array( $key ) || is_object( $key ) ) {
 73:         $key = md5( serialize( $key ) );
 74:     }
 75: 
 76:     if ( $value = wp_cache_get( $key, $group ) ) {
 77:         return $value;
 78:     }
 79: 
 80:     if ( ! is_callable( $fn ) ) {
 81:         return false;
 82:     }
 83: 
 84:     $value = call_user_func_array( $fn, $args );
 85: 
 86:     if ( empty( $value ) ) {
 87:         return $value;
 88:     }
 89: 
 90:     wp_cache_set( $key, $value, $group );
 91: 
 92:     return $value;
 93: }
 94: 
 95: /**
 96:  * Get xu cache key.
 97:  *
 98:  * @param  string $key
 99:  * @param  mixed  $suffix
100:  *
101:  * @return null|string
102:  */
103: function xu_cache_key( $key, $suffix = '' ) {
104:     if ( ! is_string( $key ) ) {
105:         return;
106:     }
107: 
108:     $key = sanitize_title_with_dashes( $key );
109:     $key = str_replace( '-', '_', $key );
110: 
111:     if ( is_array( $suffix )||is_object( $suffix ) ) {
112:         $suffix = md5( serialize( $suffix ) );
113:     }
114: 
115:     if ( $suffix === false ) {
116:         $suffix = '0';
117:     }
118: 
119:     if ( $suffix === '' || $suffix === null ) {
120:         return $key;
121:     }
122: 
123:     return sprintf( '%s:%s', $key, $suffix );
124: }
125: