Як побудувати традиційну форму входу в систему

У цьому записі ви побудуєте традиційну форму входу в систему. Звичайно, коли користувач виконує вхід, ви можете завантажувати ваших користувачів звідки завгодно - наприклад, із 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,
    ));
}

Не дайте цьому контролеру збентежити вас. Як ви побачите через секунду, коли користувач відправляє форму, система безпеки автоматично обробляє надсилання форми для вас. Якщо користувач надсилає недійсне ім'я користувача або пароль, контролер зчитує помилку відправлення форми із системи безпеки, щоб пізніше відобразити її користувачеві.

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

Наррешті, створіть шаблон:

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'),
),