Как построить традиционную форму входа в систему

В этой записи вы построите традиционную форму входа в систему. Конечно, когда пользователь выполняет вход, вы можете загружать ваших пользователей откуда угодно - например, из DB. Смотрите, , чтобы узнать больше.

Для начала, включите форму входа в систему под вашим брандмауэром:

1
2
3
4
5
6
7
8
9
10

# app/config/security.yml
security:
    # ...

    firewalls:
        main:
            anonymous: ~
            form_login:
                login_path: login
                check_path: login

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

<!-- app/config/security.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<srv:container xmlns="http://symfony.com/schema/dic/security"
    xmlns:srv="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd">

    <config>
        <firewall name="main">
            <anonymous />
            <form-login login-path="login" check-path="login" />
        </firewall>
    </config>
</srv:container>

1
2
3
4
5
6
7
8
9
10
11
12

// app/config/security.php
$container->loadFromExtension('security', array(
    'firewalls' => array(
        'main' => array(
            'anonymous'  => null,
            'form_login' => array(
                'login_path' => 'login',
                'check_path' => 'login',
            ),
        ),
    ),
));

Теперь, когда система безопасности инициирует процесс аутентификации, она будет перенаправлять пользователя на форму выполнения входа /login. Реализация этой формы входа в систему - ваша работа. Для начала, создайте новый SecurityController внутри пакета:

1
2
3
4
5
6
7
8

// src/AppBundle/Controller/SecurityController.php
namespace AppBundle\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\Controller;

class SecurityController extends Controller
{
}

Далее, сконфигурируйте маршрут, который вы ранее использовали в вашей конфигурации form_login (login):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

// src/AppBundle/Controller/SecurityController.php

// ...
use Symfony\Component\HttpFoundation\Request;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;

class SecurityController extends Controller
{
    /**
     * @Route("/login", name="login")
     */
    public function loginAction(Request $request)
    {
    }
}

1
2
3
4

# app/config/routing.yml
login:
    path:     /login
    defaults: { _controller: AppBundle:Security:login }

1
2
3
4
5
6
7
8
9
10
11

<!-- app/config/routing.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<routes xmlns="http://symfony.com/schema/routing"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/routing
        http://symfony.com/schema/routing/routing-1.0.xsd">

    <route id="login" path="/login">
        <default key="_controller">AppBundle:Security:login</default>
    </route>
</routes>

Отлично! Далее, добавьте логику к loginAction(), которая отображает форму входа:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

// src/AppBundle/Controller/SecurityController.php
use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;

public function loginAction(Request $request, AuthenticationUtils $authUtils)
{
    // получить ошибку входа, если она есть
    $error = $authUtils->getLastAuthenticationError();

    // последнее имя пользователя, введенное пользователем
    $lastUsername = $authUtils->getLastUsername();

    return $this->render('security/login.html.twig', array(
        'last_username' => $lastUsername,
        'error'         => $error,
    ));
}

Не дайте этому контроллеру смутить вас. Как вы увидите через секунду, когда пользователь отпарвляет форму, система безопасносати автоматически обрабатывает отправку формы для вас. Если пользователь отправляет недействительное имя пользователя или пароль, контроллер считывает ошибку отправки формы из системы безопасности, чтобы позже отобразить её пользователю.

Другими словами, ваша работа - отобразить форму входа и любые ошибки входа, которые могли возникнуть, но система безопасности сама заботится о проверке отправленных имени пользователя и пароля, а также об аутентификации пользователя.

Finally, create the template:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

{# app/Resources/views/security/login.html.twig #}
{# ... вы скорее всего расширите ваш базовый шаблон, вроде base.html.twig #}

{% if error %}
    <div>{{ error.messageKey|trans(error.messageData, 'security') }}</div>
{% endif %}

<form action="{{ path('login') }}" method="post">
    <label for="username">Username:</label>
    <input type="text" id="username" name="_username" value="{{ last_username }}" />

    <label for="password">Password:</label>
    <input type="password" id="password" name="_password" />

    {#
        Если вы хотите контролировать URL, на который будет перенаправлен
        пользователь при успешном входе (больше деталей ниже)
        <input type="hidden" name="_target_path" value="/account" />
    #}

    <button type="submit">login</button>
</form>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

<!-- src/AppBundle/Resources/views/Security/login.html.php -->
<?php if ($error): ?>
    <div><?php echo $error->getMessage() ?></div>
<?php endif ?>

<form action="<?php echo $view['router']->path('login') ?>" method="post">
    <label for="username">Username:</label>
    <input type="text" id="username" name="_username" value="<?php echo $last_username ?>" />

    <label for="password">Password:</label>
    <input type="password" id="password" name="_password" />

    <!--
        Если вы хотите контролировать URL, на который будет перенаправлен
        пользователь при успешном входе (больше деталей ниже)
        <input type="hidden" name="_target_path" value="/account" />
    -->

    <button type="submit">login</button>
</form>

Форма может выглядеть как угодно, но обычно она следует некоторым договорённостям:

• Элемент <form> отправляет запрос POST к маршруту login,так как это то, что вы сконфигурировали под ключом form_login в security.yml;
• Поле имени пользователя имеет имя _username, а поле пароля - _password.

Вот и всё! Когда вы отправляете форму, система безопамности автоматически проверит аккредитацию пользователя и либо аутентифицирует его, либо отправит пользователя обратно к форме входа, где будет отображена ошибка.

Повторим весь процесс:

1. Пользователь пытается получить доступ к защищённому ресурсу;
2. Брандмауэр инициирует процесс аутентификации, перенаправляя пользователя к форме входа в систему (/login);
3. Страница /login отображает форму входа через маршрут и контроллер, созданные в этом примере;
4. Пользователь отправляет форму входа в /login;
5. Система безопасности принимает запрос, проверяет отправленную пользователем аккредитацию, аутентифицирует пользователя, если всё верно, и отправляет пользователя обратно к форме входа - если нет.

1
2
3
4
5

# app/config/security.yml

# ...
access_control:
    - { path: ^/, roles: ROLE_ADMIN }

1
2
3
4
5
6
7
8
9
10
11
12
13

<!-- app/config/security.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<srv:container xmlns="http://symfony.com/schema/dic/security"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:srv="http://symfony.com/schema/dic/services"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd">

    <config>
        <!-- ... -->
        <rule path="^/" role="ROLE_ADMIN" />
    </config>
</srv:container>

1
2
3
4
5
6

// app/config/security.php

// ...
'access_control' => array(
    array('path' => '^/', 'role' => 'ROLE_ADMIN'),
),

1
2
3
4
5
6

# app/config/security.yml

# ...
access_control:
    - { path: ^/login, roles: IS_AUTHENTICATED_ANONYMOUSLY }
    - { path: ^/, roles: ROLE_ADMIN }

1
2
3
4
5
6
7
8
9
10
11
12
13
14

<!-- app/config/security.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<srv:container xmlns="http://symfony.com/schema/dic/security"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:srv="http://symfony.com/schema/dic/services"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd">

    <config>
        <!-- ... -->
        <rule path="^/login" role="IS_AUTHENTICATED_ANONYMOUSLY" />
        <rule path="^/" role="ROLE_ADMIN" />
    </config>
</srv:container>

1
2
3
4
5
6
7

// app/config/security.php

// ...
'access_control' => array(
    array('path' => '^/login', 'role' => 'IS_AUTHENTICATED_ANONYMOUSLY'),
    array('path' => '^/', 'role' => 'ROLE_ADMIN'),
),