SessionInterface
интерфейс SessionInterface
Интерфейс для сессии.
Методы
| bool | start() Инициализирует хранилище сессии. | |
| string | getId() Возвращает идентификатор сессии. | |
| setId(string $id) Устанавливает идентификатор сессии. | ||
| mixed | getName() Возвращает имя сессии. | |
| setName(string $name) Устанавливает имя сессии. | ||
| bool | invalidate(int $lifetime = null) Деактивирует текущую сессию. | |
| bool | migrate(bool $destroy = false, int $lifetime = null) Переносит текущую сессию в новый идентификатор сессии, сохраняя все атрибуты сессии. | |
| save() Принудительно сохраняет и закрывает сессию. | ||
| bool | has(string $name) Проверяет, определен ли атрибут. | |
| mixed | get(string $name, mixed $default = null) Возвращает атрибут. | |
| set(string $name, mixed $value) Устанавливает атрибут. | ||
| array | all() Возвращает атрибуты. | |
| replace(array $attributes) Устанавливает атрибуты. | ||
| mixed | remove(string $name) Удаляет атрибут. | |
| clear() Очищает все атрибуты. | ||
| bool | isStarted() Проверяет, была ли начата сессия. | |
| registerBag(SessionBagInterface $bag) Регистрирует SessionBagInterface в сессии. | ||
| SessionBagInterface | getBag(string $name) Получает экземпляр пакета по имени. | |
| MetadataBag | getMetadataBag() Получает метаданные сессии. |
Подробности
bool start()
Инициализирует хранилище сессии.
Возвращаемое значение
| bool | True, если сессия начата. |
Исключения
| RuntimeException | Если сессия не может быть начата. |
string getId()
Возвращает идентификатор сессии.
Возвращаемое значение
| string | Идентификатор сессии. |
setId(string $id)
Устанавливает идентификатор сессии.
Параметры
| string | $id |
mixed getName()
Возвращает имя сессии.
Возвращаемое значение
| mixed | Имя сессии. |
setName(string $name)
Устанавливает имя сессии.
Параметры
| string | $name |
bool invalidate(int $lifetime = null)
Деактивирует текущую сессию.
Очищает все атрибуты и всплывающие сообщения сессии, перегенерирует сессию и удаляет старую сессию из хранилища.
Параметры
| int | $lifetime | Устанавливает срок действия куки сессии. Значение null оставит системные настройки неизменными, 0 задаст куки для истечения при закрытии браузера. Время в секундах, не является меткой времени Unix. |
Возвращаемое значение
| bool | True, если сессия деактивирована, false в случае ошибки. |
bool migrate(bool $destroy = false, int $lifetime = null)
Переносит текущую сессию в новый идентификатор сессии, сохраняя все атрибуты сессии.
Параметры
| bool | $destroy | Удалить ли старую сессию или оставить ее для сбора мусора. |
| int | $lifetime | Устанавливает срок действия куки сессии. Значение null оставит системные настройки неизменными, 0 задаст куки для истечения при закрытии браузера. Время в секундах, не является меткой времени Unix. |
Возвращаемое значение
| bool | True, если сессия перенесена, false в случае ошибки. |
save()
Принудительно сохраняет и закрывает сессию.
В реальных приложениях этот метод обычно не требуется, так как сессия сохраняется автоматически по окончании выполнения кода.
bool has(string $name)
Проверяет, определен ли атрибут.
Параметры
| string | $name | Имя атрибута |
Возвращаемое значение
| bool | true, если атрибут определен, иначе false |
mixed get(string $name, mixed $default = null)
Возвращает атрибут.
Параметры
| string | $name | Имя атрибута |
| mixed | $default | Значение по умолчанию, если не найдено. |
Возвращаемое значение
| mixed |
set(string $name, mixed $value)
Устанавливает атрибут.
Параметры
| string | $name | |
| mixed | $value |
array all()
Возвращает атрибуты.
Возвращаемое значение
| array | Атрибуты |
replace(array $attributes)
Устанавливает атрибуты.
Параметры
| array | $attributes | Атрибуты |
mixed remove(string $name)
Удаляет атрибут.
Параметры
| string | $name |
Возвращаемое значение
| mixed | Удалённое значение или null, если атрибут не существует |
clear()
Очищает все атрибуты.
bool isStarted()
Проверяет, была ли начата сессия.
Возвращаемое значение
| bool |
registerBag(SessionBagInterface $bag)
Регистрирует SessionBagInterface в сессии.
Параметры
| SessionBagInterface | $bag |
SessionBagInterface getBag(string $name)
Получает экземпляр пакета по имени.
Параметры
| string | $name |
Возвращаемое значение
| SessionBagInterface |
MetadataBag getMetadataBag()
Получает метаданные сессии.
Возвращаемое значение
| MetadataBag |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/HttpFoundation/Session/SessionInterface.html