Конфігурація імен таблиць та стовпців сесії

Таблиця, використовувана для зберігання сесій, називається sessions за замовчуванням, і визначає визначені імена стовпців. Ви можете сконфігурувати ці значення за допомогою передачі другого аргумента сервісу PdoSessionHandler:

1
2
3
4
5
6
7
8

# config/services.yaml
services:
    # ...

    Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler:
        arguments:
            - '%env(DATABASE_URL)%'
            - { db_table: 'customer_session', db_id_col: 'guid' }

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

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

    <services>
        <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler" public="false">
            <argument>%env(DATABASE_URL)%</argument>
            <argument type="collection">
                <argument key="db_table">customer_session</argument>
                <argument key="db_id_col">guid</argument>
            </argument>
        </service>
    </services>
</container>

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

// config/services.php
namespace Symfony\Component\DependencyInjection\Loader\Configurator;

use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;

return static function (ContainerConfigurator $container) {
    $services = $configurator->services();

    $services->set(PdoSessionHandler::class)
        ->args([
            '%env(DATABASE_URL)%',
            ['db_table' => 'customer_session', 'db_id_col' => 'guid'],
        ])
    ;
};

Ось параметри, які ви можете сконфігурувати:

db_table (за замовчуванням: sessions):

Імʼя таблиці сесій у вашій БД;

db_username: (за замовчуванням: '')

Імʼя користувача, використовуване для зʼєднання, використовуючи конфігурацію PDO (якщо використовується зʼєднання, засноване на змінній середовища DATABASE_URL, воно перевизначає імʼя користувача, визначене у змінній середовища).

db_password: (за замовчуванням: '')

Пароль, використовуваний для зʼєднання, при використанні конфігурації PDO (якщо використовується зʼєднання, засноване на змінній середовища DATABASE_URL, воно перевизначає пароль, визначений у змінній середовища).

db_id_col (за замовчуванням: sess_id):

Імʼя стовпця, де зберігати ID сесії (тип стовпця: VARCHAR(128));

db_data_col (за замовчуванням: sess_data):

Імʼя стовпця, де зберігати дані сесії (тип стовпця: BLOB);

db_time_col (за замовчуванням: sess_time):

Імʼя стовпця, де зберігати часову відмітку сесії (тип стовпця: INTEGER);

db_lifetime_col (за замовчуванням: sess_lifetime):

Імʼя стовпця, де зберігати життєвий цикл сесії (тип стовпця: INTEGER);

db_connection_options (за замовчуванням: [])

Масив опцій зʼєднання, що відноситься до драйверу;

lock_mode (за замовчуванням: LOCK_TRANSACTIONAL)

Стратегія блокування БД для уникнення станів гонитви. Можливі значення - LOCK_NONE (не блокувати), LOCK_ADVISORY (блокувати на рівні додатку) та LOCK_TRANSACTIONAL (блокувати на рівні рядку).

Підготовка БД до зберігання сесій

До збереження сесій у БД, ви повинні створити таблицю, що зберігає інформацію. Обробник сесії надає метод під назвою createTable() для налаштування цієї таблиці для вас, відповідно до використовуваного двигуна БД:

1
2
3
4
5

try {
    $sessionHandlerService->createTable();
} catch (\PDOException $exception) {
    // таблиця не могла бути створена за якоїсь причини
}

Якщо вам краще встановлювати таблицю самостійно, рекомендовано згенерувати порожню міграцію БД за допомогою наступної команди:

1

$ php bin/console doctrine:migrations:generate

Потім, знайдіть відповідний SQL для вашої БД нижче, додайте його до файлу, і запустіть міграцію за допомогою наступної команди:

1

$ php bin/console doctrine:migrations:migrate

1
2
3
4
5
6
7

CREATE TABLE `sessions` (
    `sess_id` VARBINARY(128) NOT NULL PRIMARY KEY,
    `sess_data` BLOB NOT NULL,
    `sess_lifetime` INTEGER UNSIGNED NOT NULL,
    `sess_time` INTEGER UNSIGNED NOT NULL,
    INDEX `sessions_sess_lifetime_idx` (`sess_lifetime`)
) COLLATE utf8mb4_bin, ENGINE = InnoDB;

1
2
3
4
5
6
7

CREATE TABLE sessions (
    sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
    sess_data BYTEA NOT NULL,
    sess_lifetime INTEGER NOT NULL,
    sess_time INTEGER NOT NULL
);
CREATE INDEX sessions_sess_lifetime_idx ON sessions (sess_lifetime);

1
2
3
4
5
6
7

CREATE TABLE sessions (
    sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
    sess_data NVARCHAR(MAX) NOT NULL,
    sess_lifetime INTEGER NOT NULL,
    sess_time INTEGER NOT NULL,
    INDEX sessions_sess_lifetime_idx (sess_lifetime)
);

Конфігурація імен полів сесії

Колекція, використовувана для зберігання сесій, визначає визначені імена полів. Ви можете сконфігурувати ці значення з другим аргументом, переданим сервісу MongoDbSessionHandler:

1
2
3
4
5
6
7
8

# config/services.yaml
services:
    # ...

    Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler:
        arguments:
            - '@doctrine_mongodb.odm.default_connection'
            - { id_field: '_guid', 'expiry_field': 'eol' }

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

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

    <services>
        <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler" public="false">
            <argument type="service">doctrine_mongodb.odm.default_connection</argument>
            <argument type="collection">
                <argument key="id_field">_guid</argument>
                <argument key="expiry_field">eol</argument>
            </argument>
        </service>
    </services>
</container>

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

// config/services.php
namespace Symfony\Component\DependencyInjection\Loader\Configurator;

use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;

return static function (ContainerConfigurator $container) {
    $services = $configurator->services();

    $services->set(MongoDbSessionHandler::class)
        ->args([
            service('doctrine_mongodb.odm.default_connection'),
            ['id_field' => '_guid', 'expiry_field' => 'eol'],
        ])
    ;
};

Ось параметри, яки ви можете сконфігурувати:

id_field (за замовчуванням: _id):

Імʼя поля, де зберігати ID сесії;

data_field (за замовчуванням: data):

Імʼя поля, де зберігати дані сесії;

time_field (за замовчуванням: time):

Імʼя поля, де зберігати часову відмітку створення сесії;

expiry_field (за замовчуванням: expires_at):

Імʼя поля, де зберігати життєвий цикл сесії.