Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\Component\Plugin\Discovery;
Chris@0: 
Chris@0: /**
Chris@0:  * Interface for discovery components holding a cache of plugin definitions.
Chris@0:  */
Chris@0: interface CachedDiscoveryInterface extends DiscoveryInterface {
Chris@0: 
Chris@0:   /**
Chris@0:    * Clears static and persistent plugin definition caches.
Chris@0:    *
Chris@0:    * Don't resort to calling \Drupal::cache()->delete() and friends to make
Chris@0:    * Drupal detect new or updated plugin definitions. Always use this method on
Chris@0:    * the appropriate plugin type's plugin manager!
Chris@0:    */
Chris@0:   public function clearCachedDefinitions();
Chris@0: 
Chris@0:   /**
Chris@0:    * Disable the use of caches.
Chris@0:    *
Chris@0:    * Can be used to ensure that uncached plugin definitions are returned,
Chris@0:    * without invalidating all cached information.
Chris@0:    *
Chris@0:    * This will also remove all local/static caches.
Chris@0:    *
Chris@0:    * @param bool $use_caches
Chris@0:    *   FALSE to not use any caches.
Chris@0:    */
Chris@0:   public function useCaches($use_caches = FALSE);
Chris@0: 
Chris@0: }