summaryrefslogtreecommitdiffstats
path: root/user_guide_src/source/helpers/cookie_helper.rst
blob: 2e8db5f31321b7f71b57e4f3a55ae1e437b304c8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
#############
Cookie Helper
#############

The Cookie Helper file contains functions that assist in working with
cookies.

.. contents::
  :local:

.. raw:: html

  <div class="custom-index container"></div>

Loading this Helper
===================

This helper is loaded using the following code::

	$this->load->helper('cookie');

Available Functions
===================

The following functions are available:


.. function:: set_cookie($name[, $value = ''[, $expire = ''[, $domain = ''[, $path = '/'[, $prefix = ''[, $secure = FALSE[, $httponly = FALSE]]]]]]]])

	:param mixed $name: Cookie name *or* associative array of all of the parameters available to this function
	:param string $value: Cookie value
	:param int $expire: Number of seconds until expiration
	:param string $domain: Cookie domain (usually: .yourdomain.com)
	:param string $path: Cookie path
	:param string $prefix: Cookie name prefix
	:param bool $secure: Whether to only send the cookie through HTTPS
	:param bool $httponly: Whether to hide the cookie from JavaScript
	:returns: void

	This helper function gives you view file friendly syntax to set browser
	cookies. Refer to the :doc:`Input Library <../libraries/input>` for a
	description of its use, as this function is an alias for
	``CI_Input::set_cookie()``.


.. function:: get_cookie($index[, $xss_clean = FALSE]])

	:param string $index: Cookie name
	:param bool $xss_clean: Whether to apply XSS filtering to the returned value
	:returns: mixed

	This helper function gives you view file friendly syntax to get browser
	cookies. Refer to the :doc:`Input Library <../libraries/input>` for a
	description of its use, as this function is an alias for ``CI_Input::cookie()``.


.. function:: delete_cookie($name[, $domain = ''[, $path = '/'[, $prefix = '']]]])

	:param string $name: Cookie name
	:param string $domain: Cookie domain (usually: .yourdomain.com)
	:param string $path: Cookie path
	:param string $prefix: Cookie name prefix
	:returns: void

	Lets you delete a cookie. Unless you've set a custom path or other
	values, only the name of the cookie is needed.
	::

		delete_cookie('name');

	This function is otherwise identical to ``set_cookie()``, except that it
	does not have the value and expiration parameters. You can submit an
	array of values in the first parameter or you can set discrete
	parameters.
	::

		delete_cookie($name, $domain, $path, $prefix)