EncryptedStore
class EncryptedStore extends Store
Traits
Constants
| CONTEXT_KEY |
The context key used to store the active session for the current request. |
| STARTED_CONTEXT_KEY_PREFIX |
Context key for whether the session has been started. |
| ATTRIBUTES_CONTEXT_KEY_PREFIX |
Context key for the session attributes. |
| ID_CONTEXT_KEY_PREFIX |
Context key for the session ID. |
| protected READ_ONLY_CONTEXT_KEY_PREFIX |
Context key for whether the session is read-only. |
| protected SUPPORTED_SERIALIZATIONS |
The supported session serialization strategies. |
| protected CSRF_TOKEN_LENGTH |
The length of CSRF token strings. |
Properties
| static protected array | $macros | The registered string macros. |
from Macroable |
| protected string | $startedContextKey | The context key for whether this session has been started. |
from Store |
| protected string | $attributesContextKey | The context key for this session's attributes. |
from Store |
| protected string | $idContextKey | The context key for this session's ID. |
from Store |
| protected string | $readOnlyContextKey | The context key for whether this session is read-only. |
from Store |
| protected Encrypter | $encrypter | The encrypter instance. |
Methods
Mix another object into the class.
Dynamically handle calls to the class.
Dynamically handle calls to the class.
Create a new session instance.
Prepare the raw string data from the session for unserialization.
Marshal the ViewErrorBag in the given session attributes.
Prepare the ViewErrorBag in the given session attributes for JSON serialization.
Prepare the serialized session data for storage.
Age the flash data in the given session attributes.
Get all the session data except for a specified array of items.
Determine if the given key is missing from the session data.
Determine if any of the given keys are present and not null.
Get the value of a given key and then forget it.
Determine if the session contains old input.
Get the requested item from the flashed input array.
Put a key / value pair or array of key / value pairs in the session.
Get an item from the session, or store the default value.
Increment the value of an item in the session.
Decrement the value of an item in the session.
Flash a key / value pair to the session.
Flash a key / value pair to the session for immediate use.
Set the existence of the session on the handler if applicable.
Specify that the user has confirmed their password.
Get the encrypter instance.
Details
in
Macroable at line 30
static void
macro(string $name, callable|object $macro)
Register a custom macro.
Macros persist in a static property for the worker lifetime and apply to every subsequent call on the macroable class.
in
Macroable at line 44
static void
mixin(object $mixin, bool $replace = true)
Mix another object into the class.
Delegates to macro() for each method; registered macros persist in a static property for the worker lifetime.
in
Macroable at line 61
static bool
hasMacro(string $name)
Check if macro is registered.
in
Macroable at line 72
static void
flushMacros()
Flush the existing macros.
Clears worker-wide macros; concurrent coroutines may resolve different methods depending on timing.
in
Macroable at line 83
static mixed
__callStatic(string $method, array $parameters)
Dynamically handle calls to the class.
in
Macroable at line 108
mixed
__call(string $method, array $parameters)
Dynamically handle calls to the class.
at line 21
__construct(string $name, SessionHandlerInterface $handler, Encrypter $encrypter, string|null $id = null, string $serialization = 'php')
Create a new session instance.
in
Store at line 133
bool
start()
Start the session, reading the data from a handler.
in
Store at line 151
protected array
getAttributes()
Get the session attributes.
in
Store at line 159
protected void
setAttributes(array $attributes)
Set the session attributes.
in
Store at line 167
protected void
replaceAttributes(array $attributes)
Replace the session attributes.
in
Store at line 178
protected void
loadSession()
Load the session data from the handler.
in
Store at line 188
protected array
readFromHandler()
Read the session data from the handler.
at line 31
protected string
prepareForUnserialize(string $data)
Prepare the raw string data from the session for unserialization.
in
Store at line 220
protected array
marshalErrorBagIn(array $attributes)
Marshal the ViewErrorBag in the given session attributes.
in
Store at line 242
void
save()
Save the session data to storage.
in
Store at line 273
protected array
prepareErrorBagForSerialization(array $attributes)
Prepare the ViewErrorBag in the given session attributes for JSON serialization.
at line 43
protected string
prepareForStorage(string $data)
Prepare the serialized session data for storage.
in
Store at line 304
void
ageFlashData()
Age the flash data for the session.
in
Store at line 312
protected array
ageFlashDataIn(array $attributes)
Age the flash data in the given session attributes.
in
Store at line 324
array
all()
Get all of the session data.
in
Store at line 332
array
only(array $keys)
Get a subset of the session data.
in
Store at line 340
array
except(array $keys)
Get all the session data except for a specified array of items.
in
Store at line 348
bool
exists(array|UnitEnum|string $key)
Check if a key exists.
in
Store at line 360
bool
missing(array|UnitEnum|string $key)
Determine if the given key is missing from the session data.
in
Store at line 368
bool
has(array|UnitEnum|string $key)
Determine if a key is present and not null.
in
Store at line 378
bool
hasAny(array|UnitEnum|string $key)
Determine if any of the given keys are present and not null.
in
Store at line 388
mixed
get(UnitEnum|string $key, mixed $default = null)
Get an item from the session.
in
Store at line 396
mixed
pull(UnitEnum|string $key, mixed $default = null)
Get the value of a given key and then forget it.
in
Store at line 409
bool
hasOldInput(UnitEnum|string|null $key = null)
Determine if the session contains old input.
in
Store at line 419
mixed
getOldInput(UnitEnum|string|null $key = null, mixed $default = null)
Get the requested item from the flashed input array.
in
Store at line 427
void
replace(array $attributes)
Replace the given session attributes entirely.
in
Store at line 435
void
put(array|UnitEnum|string $key, mixed $value = null)
Put a key / value pair or array of key / value pairs in the session.
in
Store at line 452
mixed
remember(UnitEnum|string $key, Closure $callback)
Get an item from the session, or store the default value.
in
Store at line 466
void
push(UnitEnum|string $key, mixed $value)
Push a value onto a session array.
in
Store at line 478
int|float
increment(UnitEnum|string $key, int $amount = 1)
Increment the value of an item in the session.
in
Store at line 488
int|float
decrement(UnitEnum|string $key, int $amount = 1)
Decrement the value of an item in the session.
in
Store at line 496
void
flash(UnitEnum|string $key, mixed $value = true)
Flash a key / value pair to the session.
in
Store at line 510
void
now(UnitEnum|string $key, mixed $value)
Flash a key / value pair to the session for immediate use.
in
Store at line 522
void
reflash()
Reflash all of the session flash data.
in
Store at line 532
void
keep(mixed $keys = null)
Reflash a subset of the current flash data.
in
Store at line 542
protected void
mergeNewFlashes(array $keys)
Merge new flash keys into the new flash array.
in
Store at line 552
protected void
removeFromOldFlashData(array $keys)
Remove the given keys from the old flash data.
in
Store at line 560
void
flashInput(array $value)
Flash an input array to the session.
in
Store at line 568
Repository
cache()
Get the session cache instance.
in
Store at line 576
mixed
remove(UnitEnum|string $key)
Remove an item from the session, returning its value.
in
Store at line 589
void
forget(array|UnitEnum|string $keys)
Remove one or many items from the session.
in
Store at line 602
void
flush()
Remove all of the items from the session.
in
Store at line 610
bool
invalidate()
Flush the session data and regenerate the ID.
in
Store at line 628
bool
regenerate(bool $destroy = false)
Generate a new session identifier.
in
Store at line 638
bool
migrate(bool $destroy = false)
Generate a new session ID for the session.
in
Store at line 654
bool
isStarted()
Determine if the session has been started.
in
Store at line 666
void
markAsReadOnly()
Mark the session as read-only for the current request.
A read-only session is not saved, and regenerating its ID does not destroy the stored session, so the request cannot overwrite session data saved by concurrent requests. Changes made during the request remain available until it ends.
in
Store at line 674
bool
isReadOnly()
Determine if the session is read-only for the current request.
in
Store at line 682
string
getName()
Get the name of the session.
in
Store at line 693
void
setName(string $name)
Set the name of the session.
Mutates the shared session store name; per-request use races across coroutines and changes the cookie name for concurrent requests.
in
Store at line 702
string
id()
Get the current session ID.
in
Store at line 710
string
getId()
Get the current session ID.
in
Store at line 726
void
setId(string|null $id)
Set the session ID.
in
Store at line 737
bool
isValidId(string|null $id)
Determine if this is a valid session ID.
in
Store at line 745
protected string
generateSessionId()
Get a new, random session ID.
in
Store at line 753
void
setExists(bool $value)
Set the existence of the session on the handler if applicable.
in
Store at line 763
string|null
token()
Get the CSRF token value.
in
Store at line 771
void
regenerateToken()
Regenerate the CSRF token value.
in
Store at line 779
bool
hasPreviousUri()
Determine if the previous URI is available.
in
Store at line 801
string|null
previousUrl()
Get the previous URL from the session.
in
Store at line 809
void
setPreviousUrl(string $url)
Set the "previous" URL in the session.
in
Store at line 817
string|null
previousRoute()
Get the previous route name from the session.
in
Store at line 825
void
setPreviousRoute(string|null $route)
Set the "previous" route name in the session.
in
Store at line 836
void
passwordConfirmed(string|null $guard = null)
Specify that the user has confirmed their password.
The confirmation is scoped to the given guard, or to the current default guard when none is given.
in
Store at line 857
SessionHandlerInterface
getHandler()
Get the underlying session handler implementation.
in
Store at line 869
SessionHandlerInterface
setHandler(SessionHandlerInterface $handler)
Set the underlying session handler implementation.
Replaces the handler on the shared session store; per-request use races across coroutines and can route session reads or writes through the wrong handler.
in
Store at line 878
bool
handlerNeedsRequest()
Determine if the session handler needs a request.
in
Store at line 886
void
setRequestOnHandler(Request $request)
Set the request on the handler instance.
in
Store at line 896
static void
flushState()
Flush all static state.
at line 51
Encrypter
getEncrypter()
Get the encrypter instance.