Security update for Core, with self-updated composer

[yaffs-website] / web / core / lib / Drupal / Core / Entity / EntityTypeManagerInterface.php

diff --git a/web/core/lib/Drupal/Core/Entity/EntityTypeManagerInterface.php b/web/core/lib/Drupal/Core/Entity/EntityTypeManagerInterface.php
index 2a7a31733128296638cf040b0a135f8e2539e16f..d395be2ab68e243ac95d1b6bb250a1a7ca4528d1 100644 (file)
--- a/web/core/lib/Drupal/Core/Entity/EntityTypeManagerInterface.php
+++ b/web/core/lib/Drupal/Core/Entity/EntityTypeManagerInterface.php
@@ -93,7 +93,14 @@ interface EntityTypeManagerInterface extends PluginManagerInterface, CachedDisco
   public function hasHandler($entity_type, $handler_type);
 
   /**
-   * Creates a new handler instance for a entity type and handler type.
+   * Returns a handler instance for the given entity type and handler.
+   *
+   * Entity handlers are instantiated once per entity type and then cached
+   * in the entity type manager, and so subsequent calls to getHandler() for
+   * a particular entity type and handler type will return the same object.
+   * This means that properties on a handler may be used as a static cache,
+   * although as the handler is common to all entities of the same type,
+   * any data that is per-entity should be keyed by the entity ID.
    *
    * @param string $entity_type
    *   The entity type for this handler.