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

Таблица, используемая дл хранения сессий, называется 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):

Имя поля, где хранить жизненный цикл сессии.