Skip to content

Commit

Permalink
answer some questions and clarify the best chapter imo from the symfo…
Browse files Browse the repository at this point in the history
…ny documentation
  • Loading branch information
cordoval committed Jan 4, 2014
1 parent 0428c57 commit 2888d00
Showing 1 changed file with 11 additions and 3 deletions.
14 changes: 11 additions & 3 deletions components/http_foundation/session_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -28,11 +28,13 @@ PHP or provided by PHP extensions, such as PHP-Sqlite, PHP-Memcached and so on.
All native save handlers are internal to PHP and as such, have no public facing API.
They must be configured by ``php.ini`` directives, usually ``session.save_path`` and
potentially other driver specific directives. Specific details can be found in
docblock of the ``setOptions()`` method of each class.
the docblock of the ``setOptions()`` method of each class. For an example of this for
a save handler provided via the Memcached extension is
`php.net/manual/en/memcached.setoption`_

While native save handlers can be activated by directly using
``ini_set('session.save_handler', $name);``, Symfony2 provides a convenient way to
activate these in the same way as custom handlers.
activate these in the same way as it does for custom handlers.

Symfony2 provides drivers for the following native save handler as an example:

Expand Down Expand Up @@ -61,7 +63,7 @@ Example usage::
Custom Save Handlers
--------------------

Custom handlers are those which completely replace PHP's built in session save
Custom handlers are those which completely replace PHP's built-in session save
handlers by providing six callback functions which PHP calls internally at
various points in the session workflow.

Expand Down Expand Up @@ -234,6 +236,11 @@ PHP 5.4 functionality if it is available.
Save Handler Proxy
~~~~~~~~~~~~~~~~~~

A Save Handler Proxy is basically a wrapper around a Save Handler that was
introduced to support seamlessly the migration from PHP 5.3 to PHP 5.4+. It
further creates an extension point from where custom logic can be added that
works independently of which handler is being wrapped inside.

There are two kinds of save handler class proxies which inherit from
:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\AbstractProxy`:
they are :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeProxy`
Expand Down Expand Up @@ -263,3 +270,4 @@ without knowledge of the specific save handler.

.. _`php.net/session.customhandler`: http://php.net/session.customhandler
.. _`php.net/session.configuration`: http://php.net/session.configuration
.. _`php.net/manual/en/memcached.setoption`: http://php.net/manual/en/memcached.setoption

0 comments on commit 2888d00

Please sign in to comment.