ses

PHP-сессия помогает сайту помнить корзину, язык или состояние входа между запросами. ses работает с данными текущей сессии на сервере. Это не cookie: браузер обычно хранит лишь идентификатор, а сами значения остаются в PHP.

ДиагностикаВерсия 1.3.6Стабильная
lil-terminal

Обзор

PHP-сессия помогает сайту помнить корзину, язык или состояние входа между запросами. ses работает с данными текущей сессии на сервере. Это не cookie: браузер обычно хранит лишь идентификатор, а сами значения остаются в PHP.

Как пользоваться без ошибок

Начни с ses -l: увидишь ключи и их типы, не раскрывая значения. ses profile.name читает отдельное поле, ses profile.name : Ada сохраняет текст, а ses profile.active -j : true — настоящее логическое значение. Точка разделяет вложенные ключи; точку внутри имени надо экранировать. Экспорт сохраняет безопасную часть сессии в JSON-файл на хостинге. Импорт с -r может заменить существующие данные. Проверяй доступ к экспортированному файлу и удаляй его после работы. Защита скрывает ключи с характерными названиями секретов, но не гарантирует обнаружение всех секретных данных. ses -r сбрасывает рабочее состояние терминала без выхода из авторизации; ses -R уничтожает PHP-сессию и перезагружает терминал. Cookie браузера от этого не очищаются полностью.

Синтаксис

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

Справочник

ses

показать сессию как PHP-массив с сохранением иерархии; чувствительные значения скрыты

ses -l

показать ключи верхнего уровня и типы значений

ses <path>

показать ключ или экранированный точечный путь с сохранением иерархии

ses <path> : <value>

сохранить текст

ses <path> -j : <json>

сохранить JSON-значение

ses <path> -d

удалить ключ или ветвь и показать обновлённую сессию

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

выгрузить безопасные данные сессии в JSON; по умолчанию session.json

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

загрузить JSON в сессию; -r заменяет существующие данные

ses -r

сбросить рабочие данные lil-terminal, сохранив авторизацию

ses -R

уничтожить всю сессию и перезагрузить терминал

Практика и безопасность

Начни с ses -l: увидишь ключи и их типы, не раскрывая значения. ses profile.name читает отдельное поле, ses profile.name : Ada сохраняет текст, а ses profile.active -j : true — настоящее логическое значение. Точка разделяет вложенные ключи; точку внутри имени надо экранировать.

Экспорт сохраняет безопасную часть сессии в JSON-файл на хостинге. Импорт с -r может заменить существующие данные. Проверяй доступ к экспортированному файлу и удаляй его после работы.

Защита скрывает ключи с характерными названиями секретов, но не гарантирует обнаружение всех секретных данных. ses -r сбрасывает рабочее состояние терминала без выхода из авторизации; ses -R уничтожает PHP-сессию и перезагружает терминал. Cookie браузера от этого не очищаются полностью.

В Minimum доступны только ses, ses <path> и ses -l. Изменение, импорт/экспорт JSON и сброс требуют Base.

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Сохранить структурированные данные сессии и прочитать их

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install ses
Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install ses -m
Точная публичная версия

Установить именно эту опубликованную версию.

install ses -v 1.3.6
Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade ses
Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install ses -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Сохранить структурированные данные сессии и прочитать их
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
        )

)
Показать ключи верхнего уровня и типы значений
ses -l
account_token  string
auth           string
auth_prompt    array
b              string
c              string
key            object
profile        object
Показать ключ или экранированный точечный путь с сохранением иерархии
ses profile.name
Ada
Сохранить текст
ses profile.name : Ada
+
Показать ключ или экранированный точечный путь с сохранением иерархии
ses profile.name
Ada
Сохранить JSON-значение
ses profile.active -j : true
+
Защитить состояние авторизации
ses profile.active
false
Сохранить JSON-значение
ses profile.roles -j : ["editor","viewer"]
+
Показать ключ или экранированный точечный путь с сохранением иерархии
ses profile.roles
Array
(
    [0] => viewer
)
Удалить ключ или ветвь и показать обновлённую сессию
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
        )

)
Показать ключ или экранированный точечный путь с сохранением иерархии
ses profile.unknown
Session path not found
Показать ключ или экранированный точечный путь с сохранением иерархии
ses auth
[hidden]
Сохранить текст
ses auth : open
Protected session key
Сохранить JSON-значение
ses profile.active -j : {invalid}
Invalid JSON: Syntax error
Выгрузить безопасные данные сессии в JSON; по умолчанию session.json
ses export profile -o sandbox/session-profile.json
File   session-profile.json
Bytes  82
Выгрузить безопасные данные сессии в JSON; по умолчанию session.json
ses export auth -o sandbox/auth.json
Protected session key
Загрузить JSON в сессию; -r заменяет существующие данные
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
        )

)
Загрузить JSON в сессию; -r заменяет существующие данные
ses import sandbox/session-safe.json profile
Session path exists; use -r
Сбросить рабочие данные lil-terminal, сохранив авторизацию
ses -r
+
Уничтожить всю сессию и перезагрузить терминал
ses -R
PHP-сессия уничтожена, терминал перезагружается.
Показать ключи верхнего уровня и типы значений
ses -l -j
?

Связанная документация

Какие требования к серверу? →Почему ограничены большие файлы и объём вывода? →

Текущая публичная версия

v1.3.62026-11-01

Производственная доработка

Актуальная стабильная версия ses. PHP-сессия помогает сайту помнить корзину, язык или состояние входа между запросами.

# История версий