Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso del administrador de sesiones de DynamoDB con la versión 3 de AWS SDK for PHP

El administrador de sesiones de DynamoDB es un administrador de sesiones personalizado para PHP que permite a los desarrolladores utilizar Amazon DynamoDB como almacén de sesiones. Si utiliza DynamoDB para el almacenamiento de sesiones evitará que surjan problemas al gestionar sesiones en una aplicación web distribuida, ya que las sesiones se trasladan del sistema de archivos local a una ubicación compartida DynamoDB es rápido, escalable, fácil de configurar y administra la replicación de los datos de forma automática.

El administrador de sesiones de DynamoDB utiliza la función session_set_save_handler() para enlazar las operaciones de DynamoDB con las funciones de sesión nativas de PHP para permitir un verdadero reemplazo. Esto incluye admitir características como el bloqueo de sesiones y la recopilación de elementos no utilizados, que forman parte del administrador de sesiones predeterminado de PHP.

Para obtener más información sobre el servicio DynamoDB, consulte la página de inicio de Amazon DynamoDB.

Uso básico

Paso 1: Registrar el administrador

En primer lugar, cree instancias y registre el administrador de sesiones.

use Aws\DynamoDb\SessionHandler;

$dynamoDb = new Aws\DynamoDb\DynamoDbClient([
    'region'=>'us-east-1'  // Since version 3.277.10 of the SDK, 
]);                        // the 'version' parameter defaults to 'latest'.

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name' => 'sessions'
]);

$sessionHandler->register();

Paso 2. Crear una tabla para almacenar sus sesiones

Antes de poder empezar a usar el administrador de sesiones, debe crear una tabla en la que se almacenen las sesiones. Puede hacerlo previamente utilizando la consola de AWS para Amazon DynamoDB, o el AWS SDK for PHP.

Al crear esta tabla utilice "id" como nombre de la clave principal. También se recomienda configurar un atributo Tiempo de vida utilizando el atributo "expires" para beneficiarse de la recopilación automática de elementos no utilizados de las sesiones.

Paso 3. Utilizar las sesiones de PHP como suele hacerlo

Una vez registrado el administrador de sesiones y cuando la tabla ya exista, podrá escribir y leer desde la sesión utilizando la $_SESSION superglobal, tal como suele hacer con el administrador de sesiones predeterminado de PHP. El administrador de DynamoDB encapsula y abstrae las interacciones con DynamoDB y le permite utilizar las funciones de sesión nativas y la interfaz de PHP.

// Start the session
session_start();

// Alter the session data
$_SESSION['user.name'] = 'jeremy';
$_SESSION['user.role'] = 'admin';

// Close the session (optional, but recommended)
session_write_close();

Configuración

Puede configurar el comportamiento del administrador de sesiones utilizando las siguientes opciones. Todas las opciones son opcionales, pero asegúrese de que comprende cuáles son los valores predeterminados.

Para configurar el administrador de sesiones, especifique las opciones de configuración cuando cree instancias del administrador. El siguiente código es un ejemplo de todas las opciones de configuración.

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name'                    => 'sessions',
    'hash_key'                      => 'id',
    'data_attribute'                => 'data',
    'data_attribute_type'           => 'string',
    'session_lifetime'              => 3600,
    'session_lifetime_attribute'    => 'expires',
    'consistent_read'               => true,
    'locking'                       => false,
    'batch_config'                  => [],
    'max_lock_wait_time'            => 10,
    'min_lock_retry_microtime'      => 5000,
    'max_lock_retry_microtime'      => 50000,
]);

Precios

Aparte del almacenamiento de datos y las tarifas de transferencia de datos, los costos asociados al uso de DynamoDB se calculan en función de la capacidad de rendimiento aprovisionada de la tabla (consulte la información sobre precios de Amazon DynamoDB). El rendimiento se mide en unidades de capacidad de escritura y capacidad de lectura. La página de inicio de Amazon DynamoDB indica:

Una unidad de capacidad de lectura representa una lectura de consistencia alta por segundo (o bien dos lecturas consistentes finales por segundo) para elementos de un tamaño de hasta 4 KB. Una unidad de capacidad de escritura representa una escritura por segundo para elementos de un tamaño de hasta 1 KB.

En definitiva, el rendimiento y los costos necesarios para su tabla de sesiones se corresponden con el tráfico esperado y el tamaño de la sesión. La siguiente tabla explica la cantidad de operaciones de lectura y escritura que se realizan en la tabla de DynamoDB para cada una de las funciones de la sesión.

Bloqueo de sesiones

El administrador de sesiones de DynamoDB es compatible con el bloqueo de sesiones pesimista para imitar el comportamiento del administrador de sesiones predeterminado de PHP. De forma predeterminada, el administrador de sesiones de DynamoDB tiene esta característica desactivada, ya que puede convertirse en un cuello de botella de rendimiento e incrementar los costos, especialmente cuando una aplicación accede a la sesión utilizando solicitudes Ajax o iframes. Es importante plantearse si la aplicación requiere el bloqueo de sesiones antes de habilitarlo.

Para habilitar el bloqueo de sesiones, establezca la opción 'locking' en true cuando cree instancias de SessionHandler.

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name' => 'sessions',
    'locking'    => true,
]);

Recopilación de elementos no utilizados

Configure un atributo TTL en la tabla de DynamoDB, utilizando el atributo "expires". De este modo, se realizará automáticamente la recopilación de elementos no utilizados de las sesiones y se evitará la necesidad de realizarla usted mismo.

El administrador de sesiones de DynamoDB también admite la recopilación de elementos no utilizados de las sesiones mediante el uso de una serie de operaciones Scan y BatchWriteItem. Debido a la naturaleza del funcionamiento de la operación Scan, y para encontrar todas las sesiones caducadas y eliminarlas, el proceso de recopilación de elementos no utilizados puede requerir una gran cantidad de rendimiento provisionado.

Por este motivo, no se admite la recopilación automatizada. Una de las prácticas recomendadas es programar la recopilación fuera de las horas punta, cuando la ráfaga de rendimiento consumido no afecte al resto de la aplicación. Por ejemplo, puede configurar un trabajo cron por la noche que dispare un script para ejecutar la recopilación. Este script debería hacer algo similar a lo siguiente.

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name'   => 'sessions',
    'batch_config' => [
        'batch_size' => 25,
        'before' => function ($command) {
            echo "About to delete a batch of expired sessions.\n";
        }
    ]
]);

$sessionHandler->garbageCollect();

También puede utilizar la opción 'before' dentro de 'batch_config' para introducir retrasos en las operaciones BatchWriteItem que lleva a cabo el proceso de recopilación de elementos no utilizados. Esto aumentará el tiempo que se tarda en completar la recopilación de elementos no utilizados, pero puede ayudarle a distribuir las solicitudes realizadas por el administrador de sesiones de DynamoDB para mantenerse cerca o dentro de la capacidad de rendimiento provisionada durante la recopilación de elementos no utilizados.

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name'   => 'sessions',
    'batch_config' => [
        'before' => function ($command) {
            $command['@http']['delay'] = 5000;
        }
    ]
]);

$sessionHandler->garbageCollect();

Prácticas recomendadas

Permisos de IAM necesarios

Para utilizar el administrador de sesiones de DynamoDB, las credenciales configuradas deben tener permiso para utilizar la tabla de DynamoDB que creó en un paso anterior. La política de IAM siguiente contiene los permisos mínimos necesarios. Para utilizar esta política, sustituya el valor Recurso por el nombre de recurso de Amazon (ARN) de la tabla que creó anteriormente. Para obtener más información sobre cómo crear y adjuntar políticas de IAM, consulte Administración de políticas de IAM en la Guía del usuario de IAM.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:Scan",
        "dynamodb:BatchWriteItem"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:dynamodb:<region>:<account-id>:table/<table-name>"
    }
  ]
}