SubscriberRegistrationCheckerInterface

libraries/src/Event/LazyServiceEventSubscriber.php

@@ -23,7 +23,7 @@
  *
  * @since  __DEPLOY_VERSION__
  */
-final class LazyServiceEventSubscriber implements LazyEventSubscriberInterface, PluginInterface
+final class LazyServiceEventSubscriber implements LazyEventSubscriberInterface, SubscriberRegistrationCheckerInterface, PluginInterface
 {
     /**
      * The service container
@@ -105,6 +105,22 @@ public function getEventsAndListeners(): array
         return $this->eventsAndListeners;
     }
 
+    /**
+     * Check whether the Subscriber (or event listener) should be registered.
+     *
+     * @return bool
+     *
+     * @since  __DEPLOY_VERSION__
+     */
+    public function shouldRegisterListeners(): bool
+    {
+        if ($this->container->has(SubscriberRegistrationCheckerInterface::class)) {
+            return $this->container->get(SubscriberRegistrationCheckerInterface::class)->shouldRegisterListeners();
+        }
+
+        return true;
+    }
+
     /**
      * Method to call the event listeners.
      *

libraries/src/Event/SubscriberRegistrationCheckerInterface.php

@@ -0,0 +1,31 @@
+<?php
+
+/**
+ * Joomla! Content Management System
+ *
+ * @copyright  (C) 2024 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license    GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\CMS\Event;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Provides a method to check whether the Subscriber (or event listener) should be registered.
+ *
+ * @since  __DEPLOY_VERSION__
+ */
+interface SubscriberRegistrationCheckerInterface
+{
+    /**
+     * Check whether the Subscriber (or event listener) should be registered.
+     *
+     * @return bool
+     *
+     * @since  __DEPLOY_VERSION__
+     */
+    public function shouldRegisterListeners(): bool;
+}