@@ -28,11 +28,13 @@ PHP or provided by PHP extensions, such as PHP-Sqlite, PHP-Memcached and so on.
28
28
All native save handlers are internal to PHP and as such, have no public facing API.
29
29
They must be configured by ``php.ini `` directives, usually ``session.save_path `` and
30
30
potentially other driver specific directives. Specific details can be found in
31
- docblock of the ``setOptions() `` method of each class.
31
+ the docblock of the ``setOptions() `` method of each class. For an example of this for
32
+ a save handler provided via the Memcached extension is
33
+ `php.net/manual/en/memcached.setoption `_
32
34
33
35
While native save handlers can be activated by directly using
34
36
``ini_set('session.save_handler', $name); ``, Symfony2 provides a convenient way to
35
- activate these in the same way as custom handlers.
37
+ activate these in the same way as it does for custom handlers.
36
38
37
39
Symfony2 provides drivers for the following native save handler as an example:
38
40
@@ -61,7 +63,7 @@ Example usage::
61
63
Custom Save Handlers
62
64
--------------------
63
65
64
- Custom handlers are those which completely replace PHP's built in session save
66
+ Custom handlers are those which completely replace PHP's built- in session save
65
67
handlers by providing six callback functions which PHP calls internally at
66
68
various points in the session workflow.
67
69
@@ -234,6 +236,11 @@ PHP 5.4 functionality if it is available.
234
236
Save Handler Proxy
235
237
~~~~~~~~~~~~~~~~~~
236
238
239
+ A Save Handler Proxy is basically a wrapper around a Save Handler that was
240
+ introduced to support seamlessly the migration from PHP 5.3 to PHP 5.4+. It
241
+ further creates an extension point from where custom logic can be added that
242
+ works independently of which handler is being wrapped inside.
243
+
237
244
There are two kinds of save handler class proxies which inherit from
238
245
:class: `Symfony\\ Component\\ HttpFoundation\\ Session\\ Storage\\ Handler\\ AbstractProxy `:
239
246
they are :class: `Symfony\\ Component\\ HttpFoundation\\ Session\\ Storage\\ Handler\\ NativeProxy `
@@ -263,3 +270,4 @@ without knowledge of the specific save handler.
263
270
264
271
.. _`php.net/session.customhandler` : http://php.net/session.customhandler
265
272
.. _`php.net/session.configuration` : http://php.net/session.configuration
273
+ .. _`php.net/manual/en/memcached.setoption` : http://php.net/manual/en/memcached.setoption
0 commit comments