Quando falamos em aplicações web, uma das primeiras necessidades é manter as informações do usuário enquanto ele navega pelas páginas. É aí que entra o gerenciamento de sessões no Lithe, permitindo armazenar dados como informações de login ou preferências do usuário.

Instalação simples e rápida

Para começar com sessões no Lithe, você só precisa instalar o middleware de sessão via Composer. Basta executar o seguinte comando no terminal do seu projeto:

composer require lithemod/session

Isso instalará tudo que você precisa. Nada complicado, certo?

Configuração em poucos passos

Com o middleware instalado, você precisa configurá-lo em seu projeto. Mas não se preocupe, é muito fácil! Você simplesmente adiciona o middleware ao seu aplicativo usando o método use(). Aqui está um exemplo básico:

use function Lithe\Middleware\Session\session;

$app->use(session());

Feito! A sessão está configurada e pronta para ser usada. Se precisar ajustar alguns detalhes como duração da sessão, domínio ou se o cookie deve ser enviado apenas por HTTPS, basta passar esses parâmetros na configuração:

$app->use(session([
    'lifetime' => 3600, // 1-hour session
    'secure' => true,   // Only on secure connections
    'httponly' => true, // Accessible only via HTTP
]));

Trabalhando com sessões: noções básicas

Agora que tudo está configurado, vamos ser práticos. Você pode armazenar e recuperar facilmente informações da sessão nas rotas do Lithe. Por exemplo, para salvar o nome de usuário:

$app->get('/set-user', function ($req, $res) {
    $req->session->put('user', 'John Doe');
    return $res->send('User saved in the session!');
});

E para recuperar o nome:

$app->get('/get-user', function ($req, $res) {
    $user = $req->session->get('user', 'User not found');
    return $res->send('User: ' . $user);
});

É simples assim. O gerenciamento de sessões no Lithe é simples.

Dicas para usar sessões com eficiência

• Mantenha a sessão curta: Sessões longas podem ser um risco à segurança, portanto, ajuste o tempo de vida com cuidado.
• Sempre use HTTPS: se seu aplicativo estiver em produção, certifique-se de usar secure => true para garantir que os cookies de sessão sejam transmitidos com segurança.
• Limpeza de sessão: lembre-se sempre de remover os dados da sessão que não são mais necessários para evitar sobrecarregar o armazenamento.

Além do básico: funções avançadas

Se você precisar de algo mais avançado, o Lithe também permite regenerar o ID da sessão para maior segurança, verificar se a sessão está ativa ou até mesmo destruir a sessão inteira facilmente:

$app->get('/destroy-session', function ($req, $res) {
    $req->session->destroy();
    return $res->send('Session destroyed!');
});

Essa flexibilidade garante que você tenha controle total sobre o estado da sessão e a experiência do usuário em seu aplicativo.

Usar sessões no Lithe é uma tarefa simples, mas poderosa. Com apenas algumas linhas de código, você pode garantir que as informações dos seus usuários sejam mantidas de forma segura e eficiente durante toda a experiência de navegação.