interface Cookie_Backend (View source)

The Cookie_Backend interface for use with Cookie::$inst.

See Cookie_DefaultBackend and Cookie

Methods

public
__construct(array $cookies = [])

When creating the backend we want to store the existing cookies in our "existing" array. This allows us to distinguish between cookies we received or we set ourselves (and didn't get from the browser)

public
set(string $name, string $value, float $expiry = 90, string $path = null, string $domain = null, bool $secure = false, bool $httpOnly = true)

Set a cookie

public
string|null
get(string $name, bool $includeUnsent = true)

Get the cookie value by name

public
array
getAll(bool $includeUnsent = true)

Get all the cookies

public
forceExpiry(string $name, string $path = null, string $domain = null, bool $secure = false, bool $httpOnly = true)

Force the expiry of a cookie by name

Details

__construct(array $cookies = [])

When creating the backend we want to store the existing cookies in our "existing" array. This allows us to distinguish between cookies we received or we set ourselves (and didn't get from the browser)

Parameters

array $cookies

The existing cookies to load into the cookie jar

set(string $name, string $value, float $expiry = 90, string $path = null, string $domain = null, bool $secure = false, bool $httpOnly = true)

Set a cookie

Parameters

string $name

The name of the cookie

string $value

The value for the cookie to hold

float $expiry

The number of days until expiry

string $path

The path to save the cookie on (falls back to site base)

string $domain

The domain to make the cookie available on

bool $secure

Can the cookie only be sent over SSL?

bool $httpOnly

Prevent the cookie being accessible by JS

string|null get(string $name, bool $includeUnsent = true)

Get the cookie value by name

Parameters

string $name

The name of the cookie to get

bool $includeUnsent

Include cookies we've yet to send when fetching values

Return Value

string|null

The cookie value or null if unset

array getAll(bool $includeUnsent = true)

Get all the cookies

Parameters

bool $includeUnsent

Include cookies we've yet to send

Return Value

array

All the cookies

forceExpiry(string $name, string $path = null, string $domain = null, bool $secure = false, bool $httpOnly = true)

Force the expiry of a cookie by name

Parameters

string $name

The name of the cookie to expire

string $path

The path to save the cookie on (falls back to site base)

string $domain

The domain to make the cookie available on

bool $secure

Can the cookie only be sent over SSL?

bool $httpOnly

Prevent the cookie being accessible by JS