W3cubDocs

Symfony\Component\HttpFoundation\Session\Storage\MockFileSessionStorage

class MockFileSessionStorage extends MockArraySessionStorage

MockFileSessionStorage is used to mock sessions for functional testing when done in a single PHP process.

No PHP session is actually started since a session can be initialized and shutdown only once per PHP execution cycle and this class does not pollute any session related globals, including session_*() functions or session.* PHP ini directives.

Methods

	__construct(string $savePath = null, string $name = 'MOCKSESSID', MetadataBag $metaBag = null) Constructor.
	setSessionData(array $array) Sets the session data.	from MockArraySessionStorage
boolean	start() Starts the session.
Boolean	regenerate(Boolean $destroy = false, integer $lifetime = null) Regenerates id that represents this storage.
string	getId() Returns the session ID	from MockArraySessionStorage
	setId(string $id) Sets the session ID	from MockArraySessionStorage
mixed	getName() Returns the session name	from MockArraySessionStorage
	setName(string $name) Sets the session name	from MockArraySessionStorage
	save() Force the session to be saved and closed.
	clear() Clear all session data in memory.	from MockArraySessionStorage
	registerBag(SessionBagInterface $bag) Registers a SessionBagInterface for use.	from MockArraySessionStorage
SessionBagInterface	getBag(string $name) Gets a SessionBagInterface by name.	from MockArraySessionStorage
boolean	isStarted() Checks if the session is started.	from MockArraySessionStorage
	setMetadataBag(MetadataBag $bag = null) Sets the MetadataBag.	from MockArraySessionStorage
MetadataBag	getMetadataBag() Gets the MetadataBag.	from MockArraySessionStorage

Details

public __construct(string $savePath = null, string $name = 'MOCKSESSID', MetadataBag $metaBag = null)

Constructor.

Parameters

string	$savePath	Path of directory to save session files.
string	$name	Session name.
MetadataBag	$metaBag	MetadataBag instance.

public setSessionData(array $array)

Sets the session data.

Parameters

array

$array

public boolean start()

Starts the session.

Return Value

boolean

True if started.

Exceptions

RuntimeException

If something goes wrong starting the session.

public Boolean regenerate(Boolean $destroy = false, integer $lifetime = null)

Regenerates id that represents this storage.

This method must invoke sessionregenerateid($destroy) unless this interface is used for a storage object designed for unit or functional testing where a real PHP session would interfere with testing.

Note regenerate+destroy should not clear the session data in memory only delete the session data from persistent storage.

Parameters

Boolean	$destroy	Destroy session when regenerating?
integer	$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

Boolean

True if session regenerated, false if error

Exceptions

RuntimeException

If an error occurs while regenerating this storage

public string getId()

Returns the session ID

Return Value

string

The session ID or empty.

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 save()

Force the session to be saved and closed.

This method must invoke sessionwriteclose() unless this interface is used for a storage object design for unit or functional testing where a real PHP session would interfere with testing, in which case it it should actually persist the session data if required.