summaryrefslogtreecommitdiffstats
path: root/user_guide_src/source/libraries/sessions.rst
diff options
context:
space:
mode:
authorAndrey Andreev <narf@devilix.net>2014-01-06 12:08:47 +0100
committerAndrey Andreev <narf@devilix.net>2014-01-06 12:08:47 +0100
commit1ee5a997279e3f2c6fb20fb648d3620d8b1a14f5 (patch)
tree026fd24b578198b6171e8e723320063608795225 /user_guide_src/source/libraries/sessions.rst
parent3a18df1337752c89952527d55fa7eb027ebd976e (diff)
[ci skip] Update the Session library docs
Diffstat (limited to 'user_guide_src/source/libraries/sessions.rst')
-rw-r--r--user_guide_src/source/libraries/sessions.rst60
1 files changed, 33 insertions, 27 deletions
diff --git a/user_guide_src/source/libraries/sessions.rst b/user_guide_src/source/libraries/sessions.rst
index 8e117bee6..4ce355606 100644
--- a/user_guide_src/source/libraries/sessions.rst
+++ b/user_guide_src/source/libraries/sessions.rst
@@ -506,7 +506,7 @@ Class Reference
.. method:: load_driver($driver)
:param string $driver: Driver name
- :returns: object Loaded driver object
+ :returns: object
Loads a session storage driver
@@ -520,22 +520,26 @@ Class Reference
.. method:: sess_destroy()
Destroys current session
- .. note:: This function should be the last one called, and even flash variables will no longer be available.
- If you only want some items destroyed and not all, use ``unset_userdata()``.
- .. method:: sess_regenerate($destroy)
+ .. note:: This method should be the last one called, and even flash
+ variables will no longer be available after it is used.
+ If you only want some items destroyed and not all, use
+ ``unset_userdata()``.
- :param bool $destroy: Destroy session data flag (default: false)
+ .. method:: sess_regenerate([$destroy = FALSE])
+
+ :param bool $destroy: Whether to destroy session data
:returns: void
- Regenerate the current session data
+ Regenerate the current session data.
.. method:: userdata($item)
- :param string $item: name of session item
+ :param string $item: Session item name
:returns: string
- Returns a string containing the value of the passed item or NULL if the item is not found. Example::
+ Returns a string containing the value of the passed item or NULL if the item is not found.
+ Example::
$this->session->userdata('user');
//returns example@example.com considering the set_userdata example.
@@ -544,15 +548,15 @@ Class Reference
:returns: array
- Retruns array of userdata session items
+ Retruns an array with all of the session userdata items.
.. method:: all_flashdata()
:returns: array
- Retruns array of flashdata session items
+ Retruns an array with all of the session flashdata items.
- .. method:: set_userdata($newdata = array(), $newval)
+ .. method:: set_userdata($newdata[, $newval = ''])
:param mixed $newdata: Item name or array of items
:param mixed $newval: Item value or empty string (not required if $newdata is array)
@@ -568,10 +572,10 @@ Class Reference
.. method:: unset_userdata($item)
- :param mixed $item: name of item or array of items
+ :param mixed $item: Item name or an array containing multiple items
:returns: void
- Unsets previously setted items from the session. Example::
+ Unsets previously set items from the session. Example::
$this->session->unset_userdata('user');
//unsets 'user' from session data.
@@ -581,14 +585,14 @@ Class Reference
.. method:: has_userdata($item)
- :param string $item: name of item
+ :param string $item: Item name
:returns: bool
Checks if an item exists in the session.
- .. method:: set_flashdata($newdata = array(), $newval)
+ .. method:: set_flashdata($newdata[, $newval = ''])
- :param mixed $newdata: Item name or array of items
+ :param mixed $newdata: Item name or an array of items
:param mixed $newval: Item value or empty string (not required if $newdata is array)
:returns: void
@@ -603,26 +607,27 @@ Class Reference
.. method:: keep_flashdata($item)
- :param mixed $item: name of item or array of flashdata items
+ :param mixed $item: Item name or an array containing multiple flashdata items
:returns: void
- Keeps items into flashdata for one more request
+ Keeps items into flashdata for one more request.
.. method:: flashdata($item)
- :param string $item: name of session item
+ :param string $item: Flashdata item name
:returns: string
- Returns a string containing the value of the passed item or NULL if the item is not found. Example::
+ Returns a string containing the value of the passed item or NULL if the item is not found.
+ Example::
$this->session->flashdata('message');
//returns 'Test message.' considering the set_flashdata example.
- .. method:: set_tempdata($newdata = array(), $newval, $expires)
+ .. method:: set_tempdata($newdata[, $newval = ''[, $expire = 0]])
- :param mixed $newdata: Item name or array of items
+ :param mixed $newdata: Item name or array containing multiple items
:param string $newval: Item value or empty string (not required if $newdata is array)
- :param int $expires: lifetime in seconds (0 for default)
+ :param int $expire: Lifetime in seconds (0 for default)
:returns: void
Sets items into session tempdata example::
@@ -636,10 +641,10 @@ Class Reference
.. method:: unset_tempdata($item)
- :param mixed $item: name of item or array of items
+ :param mixed $item: Item name or an array containing multiple items
:returns: void
- Unsets previously setted items from the tempdata. Example::
+ Unsets previously set items from tempdata. Example::
$this->session->unset_tempdata('user');
//unsets 'user' from tempdata.
@@ -649,10 +654,11 @@ Class Reference
.. method:: tempdata($item)
- :param string $item: name of tempdata item
+ :param string $item: Tempdata item name
:returns: string
- Returns a string containing the value of the passed item or NULL if the item is not found. Example::
+ Returns a string containing the value of the passed item or NULL if the item is not found.
+ Example::
$this->session->tempdata('message');
//returns 'Test message.' considering the set_tempdata example. \ No newline at end of file