[Security] Documented CustomUserMessageAccountStatusException

Author: javiereguiluz

security/user_checkers.rst

@@ -16,14 +16,15 @@ User checkers are classes that must implement the
 defines two methods called ``checkPreAuth()`` and ``checkPostAuth()`` to
 perform checks before and after user authentication. If one or more conditions
 are not met, an exception should be thrown which extends the
+:class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAccountStatusException`,
 :class:`Symfony\\Component\\Security\\Core\\Exception\\AccountStatusException`
 or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`::
 
     namespace App\Security;
 
-    use App\Exception\AccountDeletedException;
     use App\Security\User as AppUser;
     use Symfony\Component\Security\Core\Exception\AccountExpiredException;
+    use Symfony\Component\Security\Core\Exception\CustomUserMessageAccountStatusException;
     use Symfony\Component\Security\Core\User\UserCheckerInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
 
@@ -35,9 +36,8 @@ or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationExceptio
                 return;
             }
 
-            // user is deleted, show a generic Account Not Found message.
             if ($user->isDeleted()) {
-                throw new AccountDeletedException();
+                throw new CustomUserMessageAccountStatusException('The user account was not found.');
             }
         }
 
@@ -54,6 +54,10 @@ or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationExceptio
         }
     }
 
+.. versionadded:: 5.1
+
+    The ``CustomUserMessageAccountStatusException`` class was introduced in Symfony 5.1.
+
 Enabling the Custom User Checker
 --------------------------------