ses

Uma sessão PHP pode guardar carrinho, idioma ou estado de login entre requisições. ses lê os dados da sessão atual no servidor, não os cookies do navegador.

DiagnósticoVersão 1.3.6Estável
lil-terminal

Visão geral

Uma sessão PHP pode guardar carrinho, idioma ou estado de login entre requisições. ses lê os dados da sessão atual no servidor, não os cookies do navegador.

Como usar com segurança

Comece com ses -l para ver chaves e tipos. ses profile.name lê um campo, ses profile.name : Ada grava texto e ses profile.active -j : true grava um booleano JSON. Os pontos indicam caminhos aninhados. A exportação cria um arquivo JSON na hospedagem. A importação com -r pode substituir dados existentes: confira permissões e remova cópias desnecessárias. O filtro identifica segredos sobretudo pelo nome da chave, mas não encontra todos. ses -r redefine dados de trabalho sem encerrar a autorização; ses -R destrói a sessão PHP e recarrega o terminal. Nem todos os cookies são apagados.

Sintaxe

lil-terminal
ses [path] [options] [: value]

Referência

ses

mostrar a sessão como array PHP mascarado preservando a hierarquia

ses -l

listar as chaves principais e os tipos

ses <path>

mostrar uma chave ou caminho pontuado escapado preservando a hierarquia

ses <path> : <value>

salvar texto

ses <path> -j : <json>

salvar um valor JSON

ses <path> -d

excluir uma chave ou ramo e mostrar a sessão atualizada

ses export [path] [-o <file>]

exportar dados seguros da sessão para JSON; padrão session.json

ses import <file> [path] [-r]

importar JSON para a sessão; -r substitui dados existentes

ses -r

redefinir dados de trabalho do lil-terminal mantendo a autorização

ses -R

destruir toda a sessão e recarregar o terminal

Prática e segurança

Comece com ses -l para ver chaves e tipos. ses profile.name lê um campo, ses profile.name : Ada grava texto e ses profile.active -j : true grava um booleano JSON. Os pontos indicam caminhos aninhados.

A exportação cria um arquivo JSON na hospedagem. A importação com -r pode substituir dados existentes: confira permissões e remova cópias desnecessárias.

O filtro identifica segredos sobretudo pelo nome da chave, mas não encontra todos. ses -r redefine dados de trabalho sem encerrar a autorização; ses -R destrói a sessão PHP e recarrega o terminal. Nem todos os cookies são apagados.

Minimum aceita apenas ses, ses <path> e ses -l. Edição, importação/exportação JSON e redefinição exigem Base.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Salvar dados estruturados da sessão e lê-los

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install ses
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install ses -m
Versão pública exata

Instalar exatamente esta versão publicada.

install ses -v 1.3.6
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade ses
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install ses -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Salvar dados estruturados da sessão e lê-los
ses
Array
(
    [c] => /sandbox
    [b] => /sandbox
    [profile] => Array
        (
            [name] => Ada
            [active] => 
            [roles] => Array
                (
                    [0] => viewer
                )

        )

    [auth] => [hidden]
    [auth_prompt] => [hidden]
    [account_token] => [hidden]
    [key] => Array
        (
            [theme] => sunny
        )

)
Listar as chaves principais e os tipos
ses -l
account_token  string
auth           string
auth_prompt    array
b              string
c              string
key            object
profile        object
Mostrar uma chave ou caminho pontuado escapado preservando a hierarquia
ses profile.name
Ada
Salvar texto
ses profile.name : Ada
+
Mostrar uma chave ou caminho pontuado escapado preservando a hierarquia
ses profile.name
Ada
Salvar um valor JSON
ses profile.active -j : true
+
Proteger o estado de autorização
ses profile.active
false
Salvar um valor JSON
ses profile.roles -j : ["editor","viewer"]
+
Mostrar uma chave ou caminho pontuado escapado preservando a hierarquia
ses profile.roles
Array
(
    [0] => viewer
)
Excluir uma chave ou ramo e mostrar a sessão atualizada
ses profile.name -d
Array
(
    [c] => /sandbox
    [b] => /sandbox
    [profile] => Array
        (
            [active] => 
            [roles] => Array
                (
                    [0] => viewer
                )

        )

    [auth] => [hidden]
    [auth_prompt] => [hidden]
    [account_token] => [hidden]
    [key] => Array
        (
            [theme] => sunny
        )

)
Mostrar uma chave ou caminho pontuado escapado preservando a hierarquia
ses profile.unknown
Session path not found
Mostrar uma chave ou caminho pontuado escapado preservando a hierarquia
ses auth
[hidden]
Salvar texto
ses auth : open
Protected session key
Salvar um valor JSON
ses profile.active -j : {invalid}
Invalid JSON: Syntax error
Exportar dados seguros da sessão para JSON; padrão session.json
ses export profile -o sandbox/session-profile.json
File   session-profile.json
Bytes  82
Exportar dados seguros da sessão para JSON; padrão session.json
ses export auth -o sandbox/auth.json
Protected session key
Importar JSON para a sessão; -r substitui dados existentes
ses import sandbox/session-safe.json profile -r
Array
(
    [c] => /sandbox
    [b] => /sandbox
    [profile] => Array
        (
            [name] => Bea
            [active] => 
        )

    [auth] => [hidden]
    [auth_prompt] => [hidden]
    [account_token] => [hidden]
    [key] => Array
        (
            [theme] => sunny
        )

)
Importar JSON para a sessão; -r substitui dados existentes
ses import sandbox/session-safe.json profile
Session path exists; use -r
Redefinir dados de trabalho do lil-terminal mantendo a autorização
ses -r
+
Destruir toda a sessão e recarregar o terminal
ses -R
A sessão PHP é destruída e o terminal é recarregado.
Listar as chaves principais e os tipos
ses -l -j
?

Documentação relacionada

Quais são os requisitos do servidor? →Por que arquivos grandes e saídas extensas são limitados? →

Versão pública atual

v1.3.62026-11-01

Refinamento de produção

Versão estável atual de ses. Uma sessão PHP pode guardar carrinho, idioma ou estado de login entre requisições.

# Histórico de versões