silverstripe-framework/docs/en
Daniel Hensby 3b9056fc01 NEW Cookie_Backend for managing cookie state
I've decoupled `Cookie` from the actual act of setting and getting
cookies. Currently there are a few limitations to how Cookie works that
this change mitigates:

0. `Cookie` currently changes the super global `$_COOKIE` when setting
to make the state of an application a bit more managable, but this is
bad because we shouldn't be modifying super globals
0. One can't actually change the `$cookie_class` once the
`Cookie::$inst` has been instantiated
0. One can't test cookies as there is no class that holds the state of
the cookies (it's just held in the super global which is reset as part
of `Director::test()`
0. One can't tell the origin of a cookie (eg: did the application set it
and it needs to be sent, or did we receive it from the browser?)
0. `time()` was used, so testing was made difficult
0. There was no way to get all the cookies at once (without accessing
the super global)

Todos are on the phpdoc and I'd like to write some tests for the backend
as well as update the docs (if there are any) around cookies.
DOCS Adding `Cookie` docs

Explains basic usage of `Cookie` as well as how the `Cookie_Backend`
controls the setting and getting of cookies and manages state of sent vs
received cookies
Fixing `Cookie` usage

`Cookie` is being used inconsistently with the API throughout framework.
Either by not using `force_expiry` to expire cookies or setting them to
null and then expiring them (which is redundant).
NEW `Director::test()` takes `Cookie_Backend` rather than `array` for `$cookies` param
2014-10-06 17:44:51 +13:00
..
_images Added docs for composer 2012-11-03 18:00:58 +13:00
changelogs BUG ErrorControlChain now supports exception handling 2014-09-26 16:54:34 +12:00
howto Merge remote-tracking branch 'origin/3.1' 2014-08-14 09:08:26 +12:00
installation Merge remote-tracking branch 'origin/3.1' 2014-08-14 09:08:26 +12:00
misc Removing @deprecated 3.1 functionality and classes. 2014-08-18 16:00:13 +12:00
reference NEW Cookie_Backend for managing cookie state 2014-10-06 17:44:51 +13:00
topics API Mailer can be configured to use different encoding mechanisms, and added support for unicode quoted-string encoding 2014-09-25 16:04:56 +12:00
tutorials Fixes to the :::ss parsing - extra tabs were breaking it. 2014-06-20 10:13:07 +12:00
index.md Merge remote-tracking branch 'origin/3.0' into 3.1 2013-10-07 16:18:20 +02:00