Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Provides user management for your Symfony2 Project. Compatible with Doctrine ORM & ODM, and Propel.
#1917 Compare This branch is 1536 commits ahead, 8 commits behind KnpLabs:master.
Failed to load latest commit information.
Command Removed the BC layer for Symfony 2.1 in the previous merge
Controller Update SecurityController to not use deprecated classes
DependencyInjection Fix deprecated SecurityContext usage on loginManager
Doctrine remove unused 'use' statements
Event Added the initialize event in all edition controllers
EventListener Update event subscriber to not use deprecated methods
Form Add configureOptions method to form types for SF 2.7
Mailer Merge pull request #1194 from sstok/patch-3
Model Merge branch '1.3.x'
Propel Removed isUser()
Resources Merge branch '1.3.x'
Security Fix deprecated SecurityContext usage on loginManager
Tests Update event subscriber to not use deprecated methods
Util Bumped the Symfony dependency to 2.3
Validator Removed the old unique validator
.gitignore updated test suite to use composer
.travis.yml Travis improve Merge branch '1.3.x'
FOSUserBundle.php Fix deprecated SecurityContext usage on loginManager
FOSUserEvents.php Fixed another comment referring to wrong event
README.markdown Update the documentation URL for the master branch Added basic XML Support
composer.json Update the documentation URL for the master branch
phpunit.xml.dist Fixed phpunit config



The FOSUserBundle adds support for a database-backed user system in Symfony2. It provides a flexible framework for user management that aims to handle common tasks such as user registration and password retrieval.

Features include:

  • Users can be stored via Doctrine ORM, MongoDB/CouchDB ODM or Propel
  • Registration support, with an optional confirmation per email
  • Password reset support
  • Unit tested

Note: This bundle does not provide an authentication system but can provide the user provider for the core SecurityBundle.

Caution: This bundle is developed in sync with symfony's repository. For Symfony 2.0.x, you need to use the 1.2.0 release of the bundle (or lower)

Build Status Total Downloads Latest Stable Version


The source of the documentation is stored in the Resources/doc/ folder in this bundle, and available on

Read the Documentation for master

Read the Documentation for 1.3.x


All the installation instructions are located in the documentation.


This bundle is under the MIT license. See the complete license in the bundle:



UserBundle is a knplabs initiative. See also the list of contributors.

Reporting an issue or a feature request

Issues and feature requests are tracked in the Github issue tracker.

When reporting a bug, it may be a good idea to reproduce it in a basic project built using the Symfony Standard Edition to allow developers of the bundle to reproduce the issue by simply cloning it and following some steps.

Something went wrong with that request. Please try again.