Merge branch '6.0' into 6.1

* 6.0:
  [Console] Prevent PHP 8.1 str_replace deprec on null
  Improve DE translations for Form/Validator
  [Serializer] Fix ignore attribute in Xml files
  [Console] Escape % in command name & description from getDefault*()
  [WebProfilerBundle] Fix dark theme selected line highlight color & reuse css vars
  [Mime] Check that the path is a file in the DataPart::fromPath
  [Cache] do not pass null to strlen()
  [Mailer] Sort transports alphabetically
  [Security] Fix some phpdoc
  [Serializer] Get attributeContext after converting name

Author: derrabus

Authenticator/Passport/Credentials/PasswordCredentials.php

@@ -16,7 +16,7 @@
 /**
  * Implements password credentials.
  *
- * These plaintext passwords are checked by the UserPasswordEncoder during
+ * These plaintext passwords are checked by the UserPasswordHasher during
  * authentication.
  *
  * @author Wouter de Jong <[email protected]>

Authenticator/Passport/Passport.php

@@ -17,7 +17,11 @@
 use Symfony\Component\Security\Http\Authenticator\Passport\Credentials\CredentialsInterface;
 
 /**
- * The default implementation for passports.
+ * A Passport contains all security-related information that needs to be
+ * validated during authentication.
+ *
+ * A passport badge can be used to add any additional information to the
+ * passport.
  *
  * @author Wouter de Jong <[email protected]>
  */
@@ -55,7 +59,16 @@ public function getUser(): UserInterface
         return $this->user;
     }
 
-    public function addBadge(BadgeInterface $badge): static
+    /**
+     * Adds a new security badge.
+     *
+     * A passport can hold only one instance of the same security badge.
+     * This method replaces the current badge if it is already set on this
+     * passport.
+     *
+     * @return $this
+     */
+    public function addBadge(BadgeInterface $badge): PassportInterface
     {
         $this->badges[\get_class($badge)] = $badge;