Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Provides user management for your Symfony2 Project. Compatible with Doctrine ORM & ODM, and Propel.

This branch is 1460 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 Fixed the retrieval of the DI parameter in the controller
DependencyInjection Added basic XML Support
Doctrine remove unused 'use' statements
Event Added the initialize event in all edition controllers
EventListener Change "Change Password" translation key to match translations
Form Bumped the Symfony dependency to 2.3
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 fixed UserProvider::refreshUser() not checking the class-name
Tests minor #1613 Removed the option to switch to a different templating en…
Util Bumped the Symfony dependency to 2.3
Validator Removed the old unique validator
.gitignore updated test suite to use composer
.travis.yml Improved the travis configuration Added basic XML Support
FOSUserBundle.php add deprecated errors to constructors, fix
FOSUserEvents.php Fixed another comment referring to wrong event
README.markdown Merge branch '1.3.x' Added basic XML Support
composer.json Merge branch '1.3.x'
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 bulk of the documentation is stored in the Resources/doc/ file in this bundle:

Read the Documentation for master

Read the Documentation for 1.3.x

Read the Documentation for 1.2.0 (for Symfony 2.0.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.