forked from https://github.com/symfony/symfony

This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.

Go to file

Fabien Potencier 85d40686ab merged branch drak/sessionhandler (PR #3493 ) Commits ------- `eb9bf05` [HttpFoundation] Remove hard coded assumptions and replace with API calls. `9a5fc65` [HttpFoundation] Add more tests. `68074a2` Changelog and upgrading changes. `7f33b33` Refactor SessionStorage to NativeSessionStorage. `b12ece0` [HttpFoundation][FrameworkBundle] Separate out mock session storage and stop polluting global namespace. `d687801` [HttpKernel] Mock must invoke constructor. `7b36d0c` [DoctrineBridge][HttpFoundation] Refactored tests. `39526df` [HttpFoundation] Refactor away options property. `21221f7` [FrameworkBundle] Make use of session API. `cb873b2` [HttpFoundation] Add tests and some CS/docblocks. `a6a9280` [DoctrineBridge] Refactor session storage to handler. `a1c678e` [FrameworkBundle] Add session.handler service and handler_id configuration property. `1308312` [HttpFoundation] Add and relocate tests. `88b1170` [HttpFoundation] Refactor tests. `2257a3d` [HttpFoundation] Move session handler classes. `0a064d8` [HttpFoundation] Refactor session handlers. `2326707` [HttpFoundation] Split session handler callbacks to separate object. `bb30a44` [HttpFoundation] Prepare to split out session handler callback from session storage. Discussion ---------- [2.1] Support PHP 5.4 \SessionHandler Bug fix: no Feature addition: yes Backwards compatibility break: no Symfony2 tests pass: yes Fixes the following tickets: - Todo: - This patch allows us to add services, like an encryption layer into any session handler without having to alter or inherit any code across any session handler, internal or custom. The `\SessionHandler` class exposes internal PHP's native internal session save handlers like files, memcache, and sqlite by wrapping the internal callbacks through the class giving user-space the chance to intercept, override and filter them by inheriting from `\SessionHandler`. I've written a pretty nice use-case at http://docs.php.net/sessionhandler which really shows the power of it. I never considered how to make proper use of the `\SessionHandler` in Symfony2 until I wrote the code example you see in that documentation and also because of the `AbstractSessionStorage` base class got in the way. It's really trivial to enable support for this in Symfony2 but requires to separate out the actual handlers because inheritance is not suitable. Obviously, the feature will only work with internal PHP-extension provided handlers under PHP 5.4 and will already work in PHP 5.3 with any custom handler (since they all implement `\SessionHandlerInterface`). Symfony2 will also be the first framework to support these amazing features :-D The necessary changes are really small but beautiful: The basic idea is this: `1d55d1ff14` removed inheritance and separates out the actual session handler callbacks - the part PHP processes internally. This is supported by an internal proxy mechanism: `10a36c901e` In terms of BC, not much changes net from 2.0: - We can restore the deprecated service ID: `session.storage.native` - We add a new service ID `session.handler` (and configuration alias `handler_id`) for the actual session handlers. This defaults to the renamed `session.handler.native_file` session handler (same behaviour just new name and as it's a default there is no BC break). --------------------------------------------------------------------------- by fabpot at 2012-03-03T12:15:10Z Looks good to me. Can you update the CHANGELOG and UPGRADE file accordingly and start to update the documentation at symfony/symfony-docs? Thanks for your work, the session handling in Symfony2 is starting to become amazing! --------------------------------------------------------------------------- by drak at 2012-03-04T11:09:31Z @fabpot I will start working on documentation this week and get the CHANGELOG/UPGRADING committed shortly. I'll ping when done. --------------------------------------------------------------------------- by drak at 2012-03-14T16:48:37Z @fabpot - This PR is ready now.		2012-03-15 06:59:41 +01:00
src/Symfony	merged branch drak/sessionhandler (PR #3493 )	2012-03-15 06:59:41 +01:00
tests	[HttpFoundation] Add more tests.	2012-03-14 21:28:16 +05:45
.gitignore	Added vendor directory to .gitignore	2010-06-24 10:44:28 +02:00
.travis.yml	also test PHP 5.3.2, since this is the official lowest supported PHP version	2011-12-26 01:15:21 +01:00
CHANGELOG-2.0.md	updated CHANGELOG for 2.0.11	2012-02-24 22:59:05 +01:00
CHANGELOG-2.1.md	Changelog and upgrading changes.	2012-03-14 21:00:04 +05:45
CONTRIBUTORS.md	update CONTRIBUTORS for 2.0.10	2012-02-06 10:49:11 +01:00
LICENSE	Updated LICENSE files copyright	2012-02-22 10:10:37 +01:00
README.md	set travis-ci icon to master	2011-11-23 11:36:09 +01:00
UPGRADE-2.1.md	Changelog and upgrading changes.	2012-03-14 21:00:04 +05:45
autoload.php.dist	merged 2.0	2012-03-08 19:29:37 +01:00
check_cs	[Check CS] don't replace 'else if' on twig files (closes #2961 )	2011-12-27 16:10:32 +01:00
composer.json	Removed version field	2012-02-27 09:59:20 +01:00
phpunit.xml.dist	Ignore destructive memcached tests by default	2012-02-24 13:37:42 +01:00
vendors.php	Added Propel to the vendors.php script	2012-02-14 00:28:58 +01:00

README.md

README

What is Symfony2?

Symfony2 is a PHP 5.3 full-stack web framework. It is written with speed and flexibility in mind. It allows developers to build better and easy to maintain websites with PHP.

Symfony can be used to develop all kind of websites, from your personal blog to high traffic ones like Dailymotion or Yahoo! Answers.

Requirements

Symfony2 is only supported on PHP 5.3.2 and up.

Installation

The best way to install Symfony2 is to download the Symfony Standard Edition available at http://symfony.com/download.

Documentation

The "Quick Tour" tutorial gives you a first feeling of the framework. If, like us, you think that Symfony2 can help speed up your development and take the quality of your work to the next level, read the official Symfony2 documentation.

Contributing

Symfony2 is an open source, community-driven project. If you'd like to contribute, please read the Contributing Code part of the documentation. If you're submitting a pull request, please follow the guidelines in the Submitting a Patch section.