Skip to content
Provides user management for your Symfony2 Project. Compatible with Doctrine ORM & ODM, and Propel.
Find file
Pull request Compare This branch is 1658 commits ahead, 8 commits behind KnpLabs:master.
Latest commit e770bfa @stof stof Merge branch '1.3.x'
Failed to load latest commit information.
Command Simplify the way interactions are done when there is a single question
Controller Fixed deprecated
DependencyInjection Re-added a dedicated listener for CouchDB
Doctrine fix typo getUnifOfWork to getUnitOfWork
Event Added the initialize event in all edition controllers
EventListener Use verb rather than noun
Form Fix Symfony 3.0 support
Mailer Update mailers to use constants
Model Update the convention to warn about deprecations
Propel Revert "Merge pull request #1947 from XWB/unused-properties"
Resources Merge branch '1.3.x'
Security Update login manager to use the request stack if it's available
Tests Removed support for older Doctrine versions
Util Merge branch '1.3.x'
Validator Removed the old unique validator
.gitignore Clean the gitignore rules
.travis.yml Test with stable Symfony versions Removed support for older Doctrine versions
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 Revert "Merge pull request #1947 from XWB/unused-properties"
composer.json Require symfony console for 2.3 tests
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.