Skip to content

[Form][Security] Consistent naming of FormLoginAuthenticator #17422

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jun 12, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions security.rst
Original file line number Diff line number Diff line change
Expand Up @@ -660,7 +660,7 @@ Form Login

Most websites have a login form where users authenticate using an
identifier (e.g. email address or username) and a password. This
functionality is provided by the *form login authenticator*.
functionality is provided by the built-in :class:`Symfony\\Component\\Security\\Http\Authenticator\\FormLoginAuthenticator`.

First, create a controller for the login form:

Expand Down Expand Up @@ -691,7 +691,7 @@ First, create a controller for the login form:
}
}

Then, enable the form login authenticator using the ``form_login`` setting:
Then, enable the ``FormLoginAuthenticator`` using the ``form_login`` setting:

.. configuration-block::

Expand Down Expand Up @@ -784,8 +784,8 @@ Edit the login controller to render the login form:
}
}

Don't let this controller confuse you. Its job is only to *render* the form:
the ``form_login`` authenticator will handle the form *submission* automatically.
Don't let this controller confuse you. Its job is only to *render* the form.
The ``FormLoginAuthenticator`` will handle the form *submission* automatically.
If the user submits an invalid email or password, that authenticator will store
the error and redirect back to this controller, where we read the error (using
``AuthenticationUtils``) so that it can be displayed back to the user.
Expand Down Expand Up @@ -857,7 +857,7 @@ To review the whole process:
#. The ``/login`` page renders login form via the route and controller created
in this example;
#. The user submits the login form to ``/login``;
#. The security system (i.e. the ``form_login`` authenticator) intercepts the
#. The security system (i.e. the ``FormLoginAuthenticator``) intercepts the
request, checks the user's submitted credentials, authenticates the user if
they are correct, and sends the user back to the login form if they are not.

Expand Down