Repository files navigation

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

Features include:

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

Note: This bundle doesnot provide an authentication system but canprovide the user provider for the coreSecurityBundle.

The package only receives minimal maintenance to allow existing projects to upgrade. Existing projects are expected to plan a migration away from this bundle.

New projects should not use this bundle. It is actually much easier to implement the User entity in the project (allowing to fit exactly the need of the project). Regarding the extra features of the bundle:

• the EntityUserProvider of Symfony already provides the UserProvider when using the Doctrine ORM (and other object managers integrated with Symfony have an equivalent feature)
• change password is easy to implement in the project. That's a simple form relying on core Symfony features (the validator for the current password is in core since years)
• email verification is provided byhttps://github.com/SymfonyCasts/verify-email-bundle
• password reset is provided byhttps://github.com/SymfonyCasts/reset-password-bundle
• registration is easier to implement in the project directly to fit the need of the project, especially when the User entity is in the project. symfony/form already provides everything you need
• the ProfileController showing a profile page for the user is better done in projects needing it, as the content is likely not enough anyway

The source of the documentation is stored in thedocs/ folderin this bundle.

Read the Documentation for the current branch

This bundle is under the MIT license. See the complete licensein the bundle

UserBundle is aknplabs initiative.See also the list ofcontributors.

Issues and feature requests are tracked in theGithub issue tracker.

When reporting a bug, it may be a good idea to reproduce it in a basic projectbuilt using theSymfony Standard Editionto allow developers of the bundle to reproduce the issue by simply cloning itand following some steps.