Kohana Objective Cookie Module

By default Kohana supports Cookie manipulation via it's static Kohana_Cookie class. This makes it hard to work with cookies if your application requires to support more than one, each with different settings. This module solves this problem by giving you access to cookies served as objects, rather than static methods, where each one is configurable on its own.

Features

Fully Object Oriented cookies - no longer using static Kohana_Cookie helper class.
Much more precise control over cookies (ability to precisely set each cookie's settings rather than using global ones)
Optional automatic encryption of cookie values
Optional automatic serialization of cookie values (no longer have to worry about making sure they're in string format)

Installation

Copy and paste files and folders to MODPATH/ocookie.
(Optional) Copy MODPATH/ocookie/config/ocookie.php to your APPPATH/config folder.
Add this entry under Kohana::modules array in APPPATH/bootstrap.php:

'ocookie'	=> MODPATH.'ocookie',	 // Objective Cookie

Configuration

You can configure your cookies in your APPPATH/config/ocookie.php file. The configuration is very basic and very similar to what properties Kohana_Cookie static class has:

/**
 * The array below contains cookie configuration. Array keys are the cookie
 * names.
 */
return array(
    /**
     * The following options are available:
     *
     * integer  lifetime    cookie lifetime in seconds
     * string   path        cookie path
     * string   domain      cookie domain
     * boolean  secure      whether the cookie is to be served only over HTTPS
     * boolean  httponly    whether the cookie is to be available to JS or not
     * boolean  serialize   whether to automatically serialize and unserialize cookie value
     * boolean  encrypted   whether to encrypt cookie data (overrides serialize setting)
     */
    'default' => array(
        'lifetime'      => Cookie::$expiration,
        'path'          => Cookie::$path,
        'domain'        => Cookie::$domain,
        'secure'        => Cookie::$secure,
        'httponly'      => Cookie::$httponly,
        'serialize'     => FALSE,
        'encrypted'     => FALSE,   // or encryption setting name
    ),
);

Usage examples

Get an instance of a pre-configured cookie

$cookie = oCookie::instance('my_cookie');

Get cookie value

if ($cookie->loaded())
{
    $cookie_value = $cookie->value();
}

Set a new pre-configured cookie

$cookie->set('my_cookie_value');

You can override cookie default lifetime when setting a new value

$cookie->set('my_cookie_value', 43200);

To delete a cookie simply...

$cookie->delete();

Automatically serialized and encrypted cookies

If you configure your cookie to be automatically serialized (or encrypted) the value set doesn't have to be a string. E.g.:

$cookie->set(array('red', 'blue'));

Automatic serialization also means, that the cookie will be automatically unserialized when reading.

print_r($cookie->value());

The above will output:

Array
(
    [0] => red
    [1] => blue
)

Notes

If there is no configuration available for a cookie you're trying to get an instance of, default Kohana_Cookie configuration will be used.

Acknowledgements

The code of this module is heavily based on both Kohana_Cookie and Kohana_Session classes.

kthxboosty/kohana-modules-ocookie