Basic User Management in Symfony2 with FOSUserBundle

This tutorial demonstrates how to integrate FOSUserBundle into a Symfony project for user authentication and management. FOSUserBundle simplifies user registration, login, password resets, and profile management, leveraging Symfony's security system.

Key Features of FOSUserBundle:

• Built on Symfony's security system.
• Supports MongoDB and ORMs like Doctrine and Propel.
• Minimal configuration and code changes required for integration.
• Extensible and customizable templates for a personalized user experience.
• Features like email confirmation, password resets, and profile editing.
• Supports Symfony's role-based security.

(Image: Homestead Improved Setup)

Setting up the Symfony Project:

This guide uses Homestead Improved. Add a new site to your Homestead.yml file:

sites:
    - map: symfonylogin.app
      to: /home/vagrant/Code/SymfonyLogin/web
      type: symfony
databases:
    - symfony

Add 192.168.10.10 symfonylogin.app to your /etc/hosts file. Boot the VM with vagrant up.

Install the Symfony installer within the VM using vagrant ssh and these commands:

curl -LsS http://symfony.com/installer > symfony
sudo mv symfony /usr/local/bin/symfony
chmod a+x /usr/local/bin/symfony

Create a new Symfony application:

cd Code
symfony new SymfonyLogin

Configure parameters.yml with your database and email settings. Access the skeleton application at http://symfonylogin.app. (Note: For Vagrant, you may need to adjust app_dev.php to include your host IP.)

Integrating FOSUserBundle:

1. Installation: Use Composer:

   composer require friendsofsymfony/user-bundle "~2.0@dev"

2. Bundle Registration: In AppKernel.php, add new FOSUserBundleFOSUserBundle() to the $bundles array.

3. Configuration (config.yml):

   Enable the translator:

   translator:      { fallbacks: ["%locale%"] }

   Configure security in security.yml:

   security:
       encoders:
           AppBundle\Entity\User: bcrypt
       # ... (rest of security configuration)

   Add FOSUserBundle configuration:

   fos_user:
       db_driver: orm
       firewall_name: main
       user_class: AppBundle\Entity\User
       from_email:
           address:     admin@example.com
           sender_name:    Example.com
       registration:
           confirmation:
               enabled: true
               template:   FOSUserBundle:Registration:email.txt.twig

4. User Entity (src/AppBundle/Entity/User.php): Create a User entity extending FOSUserBundleModelUser:

   <?php
   // ... (Entity code as in original example)
   ?>

5. Update Database Schema:

   php app/console doctrine:schema:update --force

6. Import Routes (routing.yml):

   fos_user:
       resource: "@FOSUserBundle/Resources/config/routing/all.xml"

(Image: Default Registration Form)

Customizing Templates:

Create app/Resources/FOSUserBundle/views/Registration/ and copy the necessary templates from vendor/friendsofsymfony/user-bundle/Resources/views/Registration/. Modify these templates to customize the registration form's appearance. Example modifications to register.html.twig and register_content.html.twig are shown in the original example.

(Image: Customized Registration Form)

Further Customization:

• Translation: Customize translation files in app/Resources/translations/.
• Login: The default login functionality is sufficient for many applications.
• Password Reset: The password reset functionality is built-in.
• User Profile: Customize the profile page template.

This enhanced summary provides a more concise and organized explanation of the FOSUserBundle integration process, while maintaining the key information and images from the original input. The FAQ section is omitted for brevity as the tutorial itself comprehensively addresses those points.

The above is the detailed content of Basic User Management in Symfony2 with FOSUserBundle. For more information, please follow other related articles on the PHP Chinese website!