Update event listener example #3155 (#5750)

Author: froemken

Documentation/ExtensionArchitecture/HowTo/Events/Index.rst

@@ -30,25 +30,9 @@ the name in the :file:`Configuration/Services.yaml` or it is not found.
 It is best practice to use a descriptive class name and to put it in the
 namespace :php:`MyVendor\MyExtension\EventListener`.
 
-..  note::
-    This example is outdated as the used event :ref:`PasswordChangeEvent`
-    does not provide the method :php:`setAsInvalid()` anymore. However, it
-    illustrates the basic principle of an event listener.
-
-..  todo: Adjust example, see also https://github.com/TYPO3-Documentation/TYPO3CMS-Reference-CoreApi/issues/3155
-
-.. literalinclude:: _Joh316PasswordInvalidator.php
+.. literalinclude:: _Joh316PasswordInformer.php
    :language: php
 
-Then register the event in your extension's :file:`Configuration/Services.yaml`:
-
-.. literalinclude:: _EventServices.yaml
-   :language: yaml
-
-Additionally, the :file:`Configuration/Services.yaml` file allows to define a different
-method name for the event listener class and to influence the order in which
-events are loaded. See :ref:`EventDispatcherRegistration` for details.
-
 Dispatch an event
 =================
 

Documentation/ExtensionArchitecture/HowTo/Events/_EventServices.yaml

@@ -0,0 +1,34 @@
+<?php
+
+// EXT:my_extension/Classes/EventListener/Joh316PasswordInformer.php
+declare(strict_types=1);
+
+namespace MyVendor\MyExtension\EventListener;
+
+use Psr\Log\LoggerInterface;
+use TYPO3\CMS\Core\Attribute\AsEventListener;
+use TYPO3\CMS\FrontendLogin\Event\PasswordChangeEvent;
+
+/**
+ * The password 'joh316' was historically used as the default password for
+ * the TYPO3 install tool.
+ * Today this password is an unsecure choice as it is well-known, too short
+ * and does not contain capital letters or special characters.
+ */
+#[AsEventListener]
+final class Joh316PasswordInvalidator
+{
+    public function __construct(
+        private readonly LoggerInterface $logger,
+    ) {}
+
+    public function __invoke(PasswordChangeEvent $event): void
+    {
+        if ($event->getRawPassword() === 'joh316') {
+            $this->logger->warning(sprintf(
+                'User %s uses the default password "joh316".',
+                $event->getUser()['username'],
+            ));
+        }
+    }
+}