Drupal 8:自定义缓存箱
Drupal的缓存系统健壮、功能齐全且可扩展。它可用于缓存渲染输出的小块或更复杂计算的结果。缓存可以存储在页面请求中、数据库中或不同的缓存系统中。
我最近需要存储从API中提取的大量数据。从API获取数据需要几秒钟的时间,因此将其缓存在站点中以便快速检索非常重要。即使只是将缓存存储在数据库中也比API快很多倍,因此在站点内缓存结果是有意义的。让用户每次做任何事情时都坐在那里等待页面加载并不是很好。
为此,我创建了一个小型Drupal服务来为我管理这个缓存。这是模块内服务YAML文件的记录。
services: my_module.cache: class: Drupal\my_module\Cache\MyCache arguments: ['@cache.default']
该类本身基本上是特定缓存箱的set和get方法,其中使用一些静态缓存来防止重复发出相同的数据库请求。缓存是基于时间的,因此它们会在24小时内到期,并且还带有标签,以便在以后明确清除它们。
cache = $cache; } /** * Sets a cache with a specific id, data and type. * * @param string $id * The cache id. * @param mixed $data * The data to be cached. * @param array $type * The type of data being cached. This is used to set up the cache tags. */ public function setCache($id, $data, $type): void { $cid = 'my_custom_cache:' . $type . ':' . $id; $tags = [ 'my_custom_cache:' . $type . ':' . $id, 'my_custom_cache:' . $type, 'my_custom_cache', ]; $tags = Cache::mergeTags($tags, [$cid]); //设置数据库缓存。 $this->cache->set($cid, $data, (new \DateTime('+1 day'))->getTimestamp(), $tags); //设置静态缓存。 $staticCache = &drupal_static(__FUNCTION__ . $cid, NULL); $staticCache = $data; } /** * Get a specific cache. * * @param string $id * The cache ID. * @param string $type * The cache type. * * @return mixed * The cache or false if the cache was not found. */ public function getCache($id, $type) { $cid = 'my_custom_cache:' . $type . ':' . $id; $staticCache = &drupal_static(__FUNCTION__ . $cid, NULL); if ($staticCache) { //如果静态缓存存在,则返回它。 return $staticCache; } //从数据库中取出缓存并返回数据组件。 $result = $this->cache->get($cid); return $result->data ?? NULL; } }
项目中完成的类有一些方法可以在需要时使缓存失效,这就是我添加缓存标签的原因。这些用于识别我需要清除的缓存桶。
默认情况下,这会将您缓存的任何内容添加到cache_default表中,该表包含未连接到此数据的其他缓存的集合。为了改变这一点并使用不同的表,我们需要设置一个自定义缓存箱。这是使用服务YAML文件中的条目完成的。然后将此自定义缓存箱传递给之前设置的缓存服务。
services: # Custom cache bin. cache.my_custom_cache: class: Drupal\Core\Cache\CacheBackendInterface tags: - { name:cache.bin} factory: cache_factory:get arguments: [my_custom_cache] # Cache service. my_module.cache: class: Drupal\my_module\Cache\MyCache arguments: ['@cache.my_custom_cache']
现在,由于我们已将自定义缓存bin注入MyCache类,因此我们存储在缓存中的任何数据都将存储在名为cache_my_custom_cache的表中。
我需要做的是让这个缓存与正常的Drupal缓存机制完全分开,这样如果缓存被清除,我就不必再次重建缓存。这将允许诸如CSS/JavaScript缓存之类的内容被刷新,而不会同时刷新我们的API缓存。为了做到这一点,我需要允许一个缓存清除事件发生,而不是从系统中清除这个自定义缓存。这是可能的,但需要覆盖一些东西才能使其正常工作。
用于加载当前缓存后端的cache_factory类将始终加载到默认的Drupal缓存系统中,因此我们需要在服务中将其覆盖为自定义服务。
cache.my_custom_cache: class: Drupal\Core\Cache\CacheBackendInterface tags: - { name:cache.bin} factory: my_custom_cache.cache_factory:get arguments: [my_custom_cache]
有了这个,我们需要建立我们刚刚定义的工厂。这首先通过设置另一个名为my_module.cache_factory的服务来完成。
# Custom cache factory, used to stipulate the loading of cache.backend.database.my_module. my_module.cache_factory: class: Drupal\my_module\Cache\CustomCacheFactory arguments: ['@settings', '%cache_default_bin_backends%'] calls: - [setContainer, ['@service_container']]
随着服务的建立,我们需要创建一个具体的缓存工厂类。这个类非常简单,我们所做的就是返回一个名为cache.backend.database.my_module的服务,该服务(尚不存在)
container->get($service_name)->get($bin); } }
要创建此服务,我们首先需要在模块服务YAML文件中定义该服务。
# Custom cache backend database factory, used to load in the CacheDatabaseBackend object. cache.backend.database.my_module: class: Drupal\my_module\Cache\DatabaseBackendFactory arguments: ['@database', '@cache_tags.invalidator.checksum', '@settings']
接下来,我们定义刚刚在上面的服务文件中定义的DatabaseBackendFactory类。该工厂用于返回一个名为CacheDatabaseBackend的对象,该对象是自定义定义的类。核心Drupal数据库缓存还保留一个名为DEFAULT_MAX_ROWS的设置,用于防止缓存系统变得太大。我打算在自定义类中增加这个设置,所以我还包含了getMaxRowsForBin方法的覆盖,允许Drupal的上游垃圾收集使用这个自定义值。
getMaxRowsForBin($bin); return new CacheDatabaseBackend($this->connection, $this->checksumProvider, $bin, $max_rows); } /** * {@inheritDoc} */ protected function getMaxRowsForBin($bin) { return CacheDatabaseBackend::DEFAULT_MAX_ROWS; } }
现在我们终于可以创建自定义缓存后端并覆盖基本缓存清除机制。这个类扩展了DatabaseBackend类,但允许我们专门覆盖缓存清除机制。本质上,我们将deleteAll()方法设置deleteCustomCaches()为什么都不做,同时还添加了我们自己的方法,该方法将使用deleteAll()父类中相同的覆盖方法删除缓存中的任何内容。
这里有很多不同的部分在起作用,但我们现在有一个自定义的缓存箱,它已与主要的缓存清除机制隔离开来。这确实意味着,如果我们确实需要在需要实现该功能时清除自定义缓存。对于我正在处理的项目,我创建了一个表单和一个自定义Drush命令,以便可以轻松清除和重建缓存。这超出了本文的范围,但确实没有太多代码可以做到这一点。您只需要创建一个表单,其中提交处理程序运行deleteCustomCaches()CacheDatabaseBackend服务中的方法。
还有一个问题是我在构建所有这些时都考虑了数据库缓存系统。通过向CustomCacheFactoryget方法添加一些检测并返回不同的缓存箱,完全可以创建缓存箱的不同实现(例如memcache)。然而,这也意味着编写大量代码来覆盖不同的缓存机制。通过上面的实现,我确信这个缓存被存储在数据库中,这仍然是获取我需要的数据的一种更快的方式,并最终降低了问题的复杂性。覆盖这些类来创建自定义接口很好,但是当我在6个月后再次访问相同的代码时,我需要记住它是如何工作的。文档只能到此为止。