Provides user management for your Symfony2 Project. Compatible with Doctrine ORM & ODM, and Propel.
#2194 Compare This branch is 1689 commits ahead, 8 commits behind KnpLabs:master.
Latest commit 07ec96d Aug 4, 2016 @XWB XWB committed on GitHub Merge pull request #2173 from bluppfisk/patch-1
Step 5 of installation must be performed before Step 1
Failed to load latest commit information.
Command Simplify the way interactions are done when there is a single question Dec 5, 2015
Controller Fixed deprecated Sep 4, 2015
DependencyInjection remove code that was only needed for symfony 2.2 and older Feb 21, 2016
Doctrine fix typo getUnifOfWork to getUnitOfWork Jan 27, 2016
Event Added the initialize event in all edition controllers Dec 27, 2012
EventListener Use verb rather than noun Sep 15, 2015
Form Fix Symfony 3.0 support Dec 28, 2015
Mailer Update mailers to use constants Nov 21, 2015
Model Fix doc block Jun 23, 2016
Propel Revert "Merge pull request #1947 from XWB/unused-properties" Sep 15, 2015
Resources Merge pull request #2173 from bluppfisk/patch-1 Aug 4, 2016
Security Update login manager to use the request stack if it's available Nov 22, 2015
Tests Removed support for older Doctrine versions Jan 27, 2016
Util Merge branch '1.3.x' Jan 27, 2016
Validator Removed the old unique validator Jul 8, 2012
.gitignore Clean the gitignore rules Jan 27, 2016
.travis.yml Test with stable Symfony versions Nov 30, 2015 Removed support for older Doctrine versions Jan 27, 2016
FOSUserBundle.php remove code that was only needed for symfony 2.2 and older Feb 21, 2016
FOSUserEvents.php add @Event annotation to let IDEs known event names and class instance May 5, 2016
README.markdown Update the documentation URL for the master branch Aug 3, 2015 Revert "Merge pull request #1947 from XWB/unused-properties" Sep 15, 2015
composer.json Add a conflict with symfony/doctrine-bridge <2.3 Jun 2, 2016
phpunit.xml.dist Fixed phpunit config Dec 14, 2011



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.