friendsofsymfony/user-bundle

Symfony FOSUserBundle

Installs: 30 406 609

Dependents: 480

Suggesters: 43

Security: 4

Stars: 3 249

Watchers: 156

Forks: 1 691

Open Issues: 116

Type:symfony-bundle

v3.2.1 2023-07-06 10:38 UTC

README

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 or MongoDB/CouchDB ODM
  • 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.

Build Status Total Downloads Latest Stable Version

Maintenance status

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 by https://github.com/SymfonyCasts/verify-email-bundle
  • password reset is provided by https://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

Documentation

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

Read the Documentation for master

Read the Documentation for 1.3.x

Installation

All the installation instructions are located in the documentation.

License

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

About

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.