[FEATURE] Add events for getObjectCountByQuery 1241 (#5747)

* Update MessageBus. ChangeLog2docs 1245

* A two new events. ChangeLog2docs 1241

* Update Documentation/ApiOverview/Events/Events/Extbase/Persistence/ModifyQueryBeforeFetchingObjectCountEvent.rst

Co-authored-by: Lina Wolf <48202465+linawolf@users.noreply.github.com>

* Update Documentation/ApiOverview/Events/Events/Extbase/Persistence/ModifyQueryBeforeFetchingObjectCountEvent.rst

Co-authored-by: Lina Wolf <48202465+linawolf@users.noreply.github.com>

* Update Documentation/ApiOverview/MessageBus/Index.rst

Co-authored-by: Lina Wolf <48202465+linawolf@users.noreply.github.com>

* Add header links

* Add missing header anchors

---------

Co-authored-by: Lina Wolf <48202465+linawolf@users.noreply.github.com>
Co-authored-by: Stefan Froemken <sfroemken@jweiland.net>

Author: 3 people

Documentation/ApiOverview/Events/Events/Extbase/Persistence/ModifyQueryBeforeFetchingObjectCountEvent.rst

@@ -0,0 +1,21 @@
+..  include:: /Includes.rst.txt
+..  index:: Events; ModifyQueryBeforeFetchingObjectCountEvent
+..  _ModifyQueryBeforeFetchingObjectCountEvent:
+
+=========================================
+ModifyQueryBeforeFetchingObjectCountEvent
+=========================================
+
+..  versionadded:: 14.0
+
+The PSR-14 event
+:php:`\TYPO3\CMS\Extbase\Event\Persistence\ModifyQueryBeforeFetchingObjectCountEvent`
+is fired before the storage backend has asked for results count
+from a given query.
+
+..  _ModifyQueryBeforeFetchingObjectCountEvent-api:
+
+API
+===
+
+..  include:: /CodeSnippets/Events/Extbase/ModifyQueryBeforeFetchingObjectCountEvent.rst.txt

Documentation/ApiOverview/Events/Events/Extbase/Persistence/ModifyResultAfterFetchingObjectCountEvent.rst

@@ -0,0 +1,20 @@
+..  include:: /Includes.rst.txt
+..  index:: Events; ModifyResultAfterFetchingObjectCountEvent
+..  _ModifyResultAfterFetchingObjectCountEvent:
+
+=========================================
+ModifyResultAfterFetchingObjectCountEvent
+=========================================
+
+..  versionadded:: 14.0
+
+The PSR-14 event
+:php:`\TYPO3\CMS\Extbase\Event\Persistence\ModifyResultAfterFetchingObjectCountEvent`
+is fired after the storage backend has counted the results from a given query.
+
+..  _ModifyResultAfterFetchingObjectCountEvent-api:
+
+API
+===
+
+..  include:: /CodeSnippets/Events/Extbase/ModifyResultAfterFetchingObjectCountEvent.rst.txt

Documentation/ApiOverview/MessageBus/Index.rst

@@ -36,9 +36,13 @@ of a consumer command.
     :local:
 
 
+..  _message-bus-everyday-usage:
+
 "Everyday" usage - as a developer
 =================================
 
+..  _message-bus-dispatch:
+
 Dispatch a message
 ------------------
 
@@ -179,6 +183,8 @@ file on your server:
     WantedBy=multi-user.target
 
 
+..  _message-bus-advanced-usage:
+
 Advanced usage
 ==============
 
@@ -220,6 +226,37 @@ The TYPO3 Core has been tested with three transports:
 *   :php:`\Symfony\Component\Messenger\Transport\InMemory\InMemoryTransport`
     (for testing)
 
+..  _message-bus-add-rate-limiter:
+
+Add rate limiter
+----------------
+
+..  versionadded:: 13.4
+
+Rate limiting can be applied to asynchronous messages processed through the
+consume command. This allows controlling message processing rates to:
+
+*   Stay within external service limits (API quotas, mail sending thresholds)
+*   Manage server resource utilization
+
+..  _message-bus-example-rate-limiter:
+
+Example: Usage of a rate limiter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Use the following configuration to limit the process of messages to
+max. 100 each 60 seconds:
+
+..  literalinclude:: _add-rate-limiter.yaml
+    :language: yaml
+    :caption: EXT:my_extension/Configuration/Services.yaml | config/system/services.yaml
+
+..  hint::
+    As TYPO3 default transport for asynchronous messages is `doctrine` you also
+    have to set the tags `identifier` to `doctrine`.
+
+
+..  _message-bus-in-memory-transport-testing:
 
 InMemoryTransport for testing
 -----------------------------
@@ -232,6 +269,8 @@ testing.
     :caption: EXT:my_extension/Configuration/Services.yaml | config/system/services.yaml
 
 
+..  _message-bus-configure-middleware:
+
 Configure a custom middleware
 -----------------------------
 
@@ -249,7 +288,6 @@ order using TYPO3's :yaml:`before` and :yaml:`after` ordering mechanism:
     :caption: EXT:my_extension/Configuration/Services.yaml | config/system/services.yaml
 
 
-
 ..  _Custom middleware: https://symfony.com/doc/current/components/messenger.html#bus
 ..  _Doctrine DBAL messenger transport: https://github.com/symfony/doctrine-messenger
 ..  _Message Bus and Message Queue in TYPO3: https://usetypo3.com/messages-in-typo3.html

Documentation/ApiOverview/MessageBus/_add-rate-limiter.yaml

@@ -0,0 +1,12 @@
+messenger.rate_limiter.limit_db_messages:
+  class: Symfony\Component\RateLimiter\RateLimiterFactory
+  arguments:
+    $config:
+      id: 'limit_db_messages'
+      policy: 'sliding_window'
+      limit: 100
+      interval: '60 seconds'
+    $storage: '@TYPO3\CMS\Core\RateLimiter\Storage\CachingFrameworkStorage'
+  tags:
+    - name: 'messenger.rate_limiter'
+      identifier: 'doctrine'

Documentation/CodeSnippets/Config/Api/Events/EventsExtbase.php

@@ -43,6 +43,18 @@
         'targetFileName' => 'CodeSnippets/Events/Extbase/EntityUpdatedInPersistenceEvent.rst.txt',
         'withCode' => false,
     ],
+    [
+        'action' => 'createPhpClassDocs',
+        'class' => \TYPO3\CMS\Extbase\Event\Persistence\ModifyQueryBeforeFetchingObjectCountEvent::class,
+        'targetFileName' => 'CodeSnippets/Events/Extbase/ModifyQueryBeforeFetchingObjectCountEvent.rst.txt',
+        'withCode' => false,
+    ],
+    [
+        'action' => 'createPhpClassDocs',
+        'class' => \TYPO3\CMS\Extbase\Event\Persistence\ModifyResultAfterFetchingObjectCountEvent::class,
+        'targetFileName' => 'CodeSnippets/Events/Extbase/ModifyResultAfterFetchingObjectCountEvent.rst.txt',
+        'withCode' => false,
+    ],
     [
         'action' => 'createPhpClassDocs',
         'class' => \TYPO3\CMS\Extbase\Event\Persistence\ModifyQueryBeforeFetchingObjectDataEvent::class,