W3cubDocs

/Symfony 3.0

Symfony\Component\HttpFoundation\Session\Session

class Session implements SessionInterface, IteratorAggregate, Countable

Session.

Methods

__construct(SessionStorageInterface $storage = null, AttributeBagInterface $attributes = null, FlashBagInterface $flashes = null)

Constructor.

bool start()

Starts the session storage.

bool has(string $name)

Checks if an attribute is defined.

mixed get(string $name, mixed $default = null)

Returns an attribute.

set(string $name, mixed $value)

Sets an attribute.

array all()

Returns attributes.

replace(array $attributes)

Sets attributes.

mixed remove(string $name)

Removes an attribute.

clear()

Clears all attributes.

bool isStarted()

Checks if the session was started.

ArrayIterator getIterator()

Returns an iterator for attributes.

int count()

Returns the number of attributes.

bool invalidate(int $lifetime = null)

Invalidates the current session.

bool migrate(bool $destroy = false, int $lifetime = null)

Migrates the current session to a new session id while maintaining all session attributes.

save()

Force the session to be saved and closed.

string getId()

Returns the session ID.

setId(string $id)

Sets the session ID.

mixed getName()

Returns the session name.

setName(string $name)

Sets the session name.

MetadataBag getMetadataBag()

Gets session meta.

registerBag(SessionBagInterface $bag)

Registers a SessionBagInterface with the session.

SessionBagInterface getBag(string $name)

Gets a bag instance by name.

FlashBagInterface getFlashBag()

Gets the flashbag interface.

Details

public __construct(SessionStorageInterface $storage = null, AttributeBagInterface $attributes = null, FlashBagInterface $flashes = null)

Constructor.

Parameters

SessionStorageInterface $storage A SessionStorageInterface instance.
AttributeBagInterface $attributes An AttributeBagInterface instance, (defaults null for default AttributeBag)
FlashBagInterface $flashes A FlashBagInterface instance (defaults null for default FlashBag)

public bool start()

Starts the session storage.

Return Value

bool True if session started.

Exceptions

RuntimeException If session fails to start.

public bool has(string $name)

Checks if an attribute is defined.

Parameters

string $name The attribute name

Return Value

bool true if the attribute is defined, false otherwise

public mixed get(string $name, mixed $default = null)

Returns an attribute.

Parameters

string $name The attribute name
mixed $default The default value if not found.

Return Value

mixed

public set(string $name, mixed $value)

Sets an attribute.

Parameters

string $name
mixed $value

public array all()

Returns attributes.

Return Value

array Attributes

public replace(array $attributes)

Sets attributes.

Parameters

array $attributes Attributes

public mixed remove(string $name)

Removes an attribute.

Parameters

string $name

Return Value

mixed The removed value or null when it does not exist

public clear()

Clears all attributes.

public bool isStarted()

Checks if the session was started.

Return Value

bool

public ArrayIterator getIterator()

Returns an iterator for attributes.

Return Value

ArrayIterator An \ArrayIterator instance

public int count()

Returns the number of attributes.

Return Value

int The number of attributes

public bool invalidate(int $lifetime = null)

Invalidates the current session.

Clears all session attributes and flashes and regenerates the session and deletes the old session from persistence.

Parameters

int $lifetime Sets the cookie lifetime for the session cookie. A null value will leave the system settings unchanged, 0 sets the cookie to expire with browser session. Time is in seconds, and is not a Unix timestamp.

Return Value

bool True if session invalidated, false if error.

public bool migrate(bool $destroy = false, int $lifetime = null)

Migrates the current session to a new session id while maintaining all session attributes.

Parameters

bool $destroy Whether to delete the old session or leave it to garbage collection.
int $lifetime Sets the cookie lifetime for the session cookie. A null value will leave the system settings unchanged, 0 sets the cookie to expire with browser session. Time is in seconds, and is not a Unix timestamp.

Return Value

bool True if session migrated, false if error.

public save()

Force the session to be saved and closed.

This method is generally not required for real sessions as the session will be automatically saved at the end of code execution.

public string getId()

Returns the session ID.

Return Value

string The session ID.

public setId(string $id)

Sets the session ID.

Parameters

string $id

public mixed getName()

Returns the session name.

Return Value

mixed The session name.

public setName(string $name)

Sets the session name.

Parameters

string $name

public MetadataBag getMetadataBag()

Gets session meta.

Return Value

MetadataBag

public registerBag(SessionBagInterface $bag)

Registers a SessionBagInterface with the session.

Parameters

SessionBagInterface $bag

public SessionBagInterface getBag(string $name)

Gets a bag instance by name.

Parameters

string $name

Return Value

SessionBagInterface

public FlashBagInterface getFlashBag()

Gets the flashbag interface.

Return Value

FlashBagInterface

© 2004–2016 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/HttpFoundation/Session/Session.html