NEW: translation EN (current sessions.md file) to ES (new sessions.es.md file)

Author: TheHandyOwl

docs/advanced/sessions.es.md

@@ -1,101 +1,102 @@
-# Sessions
+# Sesiones
 
-Sessions allow you to persist a user's data between multiple requests. Sessions work by creating and returning a unique cookie alongside the HTTP response when a new session is initialized. Browsers will automatically detect this cookie and include it in future requests. This allows Vapor to automatically restore a specific user's session in your request handler. 
+Las sesiones te permiten conservar los datos de un usuario entre varias solicitudes. Las sesiones funcionan creando y devolviendo una cookie única junto con la respuesta HTTP cuando se inicializa una nueva sesión. Los navegadores detectarán automáticamente esta cookie y la incluirán en futuras solicitudes. Esto permite que Vapor restaure automáticamente la sesión de un usuario específico en su controlador de solicitudes.
 
-Sessions are great for front-end web applications built in Vapor that serve HTML directly to web browsers. For APIs, we recommend using stateless, [token-based authentication](../security/authentication.md) to persist user data between requests.
+Las sesiones son ideales para aplicaciones web front-end creadas en Vapor que sirven HTML directamente a los navegadores web. Para APIs, recomendamos usar autenticación sin estado, [autenticación basada en tokens](../security/authentication.md) para persistir los datos del usuario entre solicitudes.
 
-## Configuration
+## Configuración
 
-
-To use sessions in a route, the request must pass through `SessionsMiddleware`. The easiest way to achieve this is by adding this middleware globally. It is recommended that you do add this after you declare the cookie factory. This is because Sessions is a struct, therefore it is a value type, and not a reference type. Since it is a value type, you must set the value before using `SessionsMiddleware`.
+Para usar sesiones en una ruta, la solicitud debe pasar por `SessionsMiddleware`. La forma más fácil de lograr esto es agregando este middleware globalmente. Se recomienda que lo agregues después de declarar la fábrica de cookies. Esto se debe a que Sessions es una estructura, por lo tanto, es un tipo por valor y no un tipo por referencia. Dado que es un tipo por valor, debes establecer el valor antes de usar `SessionsMiddleware`.
 
 ```swift
 app.middleware.use(app.sessions.middleware)
 ```
 
-If only a subset of your routes utilize sessions, you can instead add `SessionsMiddleware` to a route group.
+Si solo un subconjunto de tus rutas utiliza sesiones, puedes añadir `SessionsMiddleware` a un grupo de rutas.
 
 ```swift
 let sessions = app.grouped(app.sessions.middleware)
 ```
 
-The HTTP cookie generated by sessions can be configured using `app.sessions.configuration`. You can change the cookie name and declare a custom function for generating cookie values.
+La cookie HTTP generada por las sesiones se puede configurar usando `app.sessions.configuration`. Puedes cambiar el nombre de la cookie y declarar una función personalizada para generar valores de las cookies.
 
 ```swift
-// Change the cookie name to "foo".
+// Cambia el nombre de la cookie a "foo".
 app.sessions.configuration.cookieName = "foo"
 
-// Configures cookie value creation.
+// Configura la creación del valor de la cookie.
 app.sessions.configuration.cookieFactory = { sessionID in
     .init(string: sessionID.string, isSecure: true)
 }
 
 app.middleware.use(app.sessions.middleware)
 ```
 
-By default, Vapor will use `vapor_session` as the cookie name.
-
-## Drivers
+De manera predeterminada, Vapor usará `vapor_session` como nombre de la cookie.
 
-Session drivers are responsible for storing and retrieving session data by identifier. You can create custom drivers by conforming to the `SessionDriver` protocol.
+## Controladores
 
-!!! warning
-	The session driver should be configured _before_ adding `app.sessions.middleware` to your application.
+Los controladores de sesión son responsables de almacenar y recuperar datos de sesión por identificador. Puedes crear controladores personalizados conformando al protocolo `SessionDriver`.
 
-### In-Memory
+!!! warning "Advertencia"
+    El controlador de sesión debe configurarse _antes_ de añadir `app.sessions.middleware` a tu aplicación.
+    
+### En Memoria
 
-Vapor utilizes in-memory sessions by default. In-memory sessions require zero configuration and do not persist between application launches which makes them great for testing. To enable in-memory sessions manually, use `.memory`:
+Vapor utiliza sesiones en memoria por defecto. Las sesiones en memoria no requieren ninguna configuración y no persisten entre lanzamientos de la aplicación, lo que las hace ideales para realizar pruebas. Para habilitar en memoria las sesiones de forma manual, usa `.memory`:
 
 ```swift
 app.sessions.use(.memory)
 ```
 
-For production use cases, take a look at the other session drivers which utilize databases to persist and share sessions across multiple instances of your app.
+Para casos de uso en producción, echa un vistazo a los otros controladores de sesión que utilizan bases de datos para persistir y compartir sesiones a través de múltiples instancias de tu aplicación.
 
 ### Fluent
 
-Fluent includes support for storing session data in your application's database. This section assumes you have [configured Fluent](../fluent/overview.md) and can connect to a database. The first step is to enable the Fluent sessions driver.
+Fluent incluye soporte para almacenar datos de sesión en la base de datos de tu aplicación. Esta sección supone que has [configurado Fluent](../fluent/overview.md) y puedes conectarte a una base de datos. El primer paso es habilitar el controlador de sesiones de Fluent.
 
 ```swift
 import Fluent
 
 app.sessions.use(.fluent)
 ```
 
-This will configure sessions to use the application's default database. To specify a specific database, pass the database's identifier.
+Esto configurará las sesiones para usar la base de datos por defecto de la aplicación. Para especificar una base de datos específica, pasa el identificador de la base de datos.
 
 ```swift
 app.sessions.use(.fluent(.sqlite))
 ```
 
 Finally, add `SessionRecord`'s migration to your database's migrations. This will prepare your database for storing session data in the `_fluent_sessions` schema.
 
+Por último, añade la migración de `SessionRecord` a las migraciones de tu base de datos. Esto preparará tu base de datos para almacenar datos de sesión en el esquema `_fluent_sessions`.
+
 ```swift
 app.migrations.add(SessionRecord.migration)
 ```
 
-Make sure to run your application's migrations after adding the new migration. Sessions will now be stored in your application's database allowing them to persist between restarts and be shared between multiple instances of your app.
+Asegúrate de ejecutar las migraciones de tu aplicación después de añadir la nueva migración. Las sesiones ahora se almacenarán en la base de datos de tu aplicación, permitiendo que se persistan entre reinicios y sean compartidas entre varias instancias de tu aplicación.
 
 ### Redis
 
-Redis provides support for storing session data in your configured Redis instance. This section assumes you have [configured Redis](../redis/overview.md) and can send commands to the Redis instance.
+Redis proporciona soporte para almacenar datos de sesión en tu instancia Redis configurada. Esta sección supone que has [configurado Redis](../redis/overview.md) y puedes enviar comandos a la instancia Redis.
 
-To use Redis for Sessions, select it when configuring your application:
+Para usar Redis para sesiones, selecciónalo al configurar tu aplicación:
 
 ```swift
 import Redis
 
 app.sessions.use(.redis)
 ```
 
-This will configure sessions to use the Redis sessions driver with the default behavior.
-
-!!! seealso
-    Refer to [Redis → Sessions](../redis/sessions.md) for more detailed information about Redis and Sessions.
+Esto configurará las sesiones para usar el controlador de sesiones Redis con el comportamiento por defecto.
 
-## Session Data
+!!! seealso "Ver también"
+    Consulte [Redis → Sessions](../redis/sessions.md) para obtener información más detallada sobre Redis y Sessions.
+    
+## Datos de Sesión
 
-Now that sessions are configured, you are ready to persist data between requests. New sessions are initialized automatically when data is added to `req.session`. The example route handler below accepts a dynamic route parameter and adds the value to `req.session.data`.
+Ahora que las sesiones están configuradas, estás listo para persistir datos entre solicitudes. Las nuevas sesiones se inicializan automáticamente cuando se añaden datos a `req.session`. A continuación, el controlador de ruta de ejemplo acepta un parámetro de ruta dinámica y agrega el valor a `req.session.data`.
 
 ```swift
 app.get("set", ":value") { req -> HTTPStatus in
@@ -104,41 +105,41 @@ app.get("set", ":value") { req -> HTTPStatus in
 }
 ```
 
-Use the following request to initialize a session with the name Vapor.
+Utiliza la siguiente solicitud para inicializar una sesión con el nombre Vapor.
 
 ```http
 GET /set/vapor HTTP/1.1
 content-length: 0
 ```
 
-You should receive a response similar to the following:
+Deberías recibir una respuesta similar a la siguiente:
 
 ```http
 HTTP/1.1 200 OK
 content-length: 0
 set-cookie: vapor-session=123; Expires=Fri, 10 Apr 2020 21:08:09 GMT; Path=/
 ```
 
-Notice the `set-cookie` header has been added automatically to the response after adding data to `req.session`. Including this cookie in subsequent requests will allow access to the session data.
+Observa que la cabecera `set-cookie` se ha añadido automáticamente a la respuesta después de añadir datos a `req.session`. Incluir esta cookie en solicitudes posteriores permitirá acceder a los datos de la sesión.
 
-Add the following route handler for accessing the name value from the session.
+Añade el siguiente controlador de ruta para acceder al valor del nombre desde la sesión.
 
 ```swift
 app.get("get") { req -> String in
     req.session.data["name"] ?? "n/a"
 }
 ```
 
-Use the following request to access this route while making sure to pass the cookie value from the previous response.
+Utiliza la siguiente solicitud para acceder a esta ruta asegurándote de pasar el valor de la cookie de la respuesta anterior.
 
 ```http
 GET /get HTTP/1.1
 cookie: vapor-session=123
 ```
 
-You should see the name Vapor returned in the response. You can add or remove data from the session as you see fit. Session data will be synchronized with the session driver automatically before returning the HTTP response. 
+Deberías ver el nombre Vapor devuelto en la respuesta. Puedes añadir o eliminar datos de la sesión como creas conveniente. Los datos de la sesión se sincronizarán con el controlador de sesión automáticamente antes de devolver la respuesta HTTP.
 
-To end a session, use `req.session.destroy`. This will delete the data from the session driver and invalidate the session cookie. 
+Para finalizar una sesión, utiliza `req.session.destroy`. Esto eliminará los datos del controlador de sesión e invalidará la cookie de sesión.
 
 ```swift
 app.get("del") { req -> HTTPStatus in

docs/advanced/sessions.md

@@ -6,7 +6,6 @@ Sessions are great for front-end web applications built in Vapor that serve HTML
 
 ## Configuration
 
-
 To use sessions in a route, the request must pass through `SessionsMiddleware`. The easiest way to achieve this is by adding this middleware globally. It is recommended that you do add this after you declare the cookie factory. This is because Sessions is a struct, therefore it is a value type, and not a reference type. Since it is a value type, you must set the value before using `SessionsMiddleware`.
 
 ```swift