原文地址http://symfony.com/doc/current/bundles/FOSUserBundle/groups.html

FOSUserBundle允许你对用户进行分组. 分组是区分角色集合的一种方式. 一个组里面的用户会被授予这个组里面所有角色的权限.

Symfony支持角色继承, 所以从组中继承角色不是必须的. 如果在你的使用场景中继承了足够多的角色, 最好还是使用继承, 因为它更为高效.(分组功能需要数据库的驱动.)

你需要在配置文件中明确启用这个启用分组功能. 唯一强制性的就是要配置你实现了FOS\UserBundle\Model\GroupInterface接口的Group类的完全限定名(fully qualified class name).

原文地址: http://symfony.com/doc/current/bundles/FOSUserBundle/emails.html

FOSUserBundle内置了两种不同的发送邮件的实例.

注册确认

在一个新用户注册完成之前, 如果在FOSUserBundle中配置了必须通过邮件确认的步骤, 系统会发送一封带有链接的邮件到用户邮箱中. 用户访问链接之后会对用户账户进行验证并且激活.

通过邮件验证新用户注册默认是关闭的. 若要启用, 则需修改配置文件:

1
2
3
4
5
6

# app/config/config.yml
fos_user:
    # ...
    registration:
        confirmation:
            enabled: true

原文地址: http://symfony.com/doc/current/bundles/FOSUserBundle/form_type.html

FOSUserBundle提供了一个名为fos_user_username的用户名表单字段. 它是一个文本输入框, 接受用户名并且将其添加至用户实例中:

1
2
3
4
5
6
7
8
9
10

class MessageFormType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder->add('recipient', 'FOS\UserBundle\Form\Type\UsernameFormType');

        // if you are using Symfony < 2.8 you should use the old name instead
        // $builder->add('recipient', 'fos_user_username');
    }
}

假如你不想在应用中使用这种表单字段, 可以删除容器服务中的配置来禁用它:

# app/config/config.yml
fos_user:
    use_username_form_type: false

原文地址http://symfony.com/doc/current/bundles/FOSUserBundle/logging_by_username_or_email.html

在FOSUserBundle的1.3.0版本中, 内建了通过用户名或者邮件字段登录功能的实现. 要启用这个功能只需修改配置中的用户服务提供器的id即可.

1
2
3
4
5

# app/config/security.yml
security:
    providers:
        fos_userbundle:
            id: fos_user.user_provider.username_email

原文地址http://symfony.com/doc/current/bundles/FOSUserBundle/command_line_tools.html

FOSUserBundle提供了大量的命令行工具来帮助你管理应用中的用户. 有这些命令任务可用:

1. Create a User (创建用户)
2. Activate a User (激活用户)
3. Deactivate a User (停用用户)
4. Promote a User (设置用户权限)
5. Demote a User (清除用户权限)
6. Change a User’s Password ( 重置用户密码)

在使用这些命令行之前, 你需要正确的安装以及配置好FOSUserBundle

此文中引用的是Symfony3的控制bin/console. 如果你使用的Symfony2, 请调用app/console.

原文地址http://symfony.com/doc/current/bundles/FOSUserBundle/user_manager.html

所有用户操作都实现了FOS\UserBundle\Model\UserManagerInterface接口, 从而实现了与存储方式的分离. 使用这个接口可以确保你能够随意的改变存储方式. FOSUserBundle提供的默认控制器使用的是配置中的用户管理, 而不是直接调用的数据存储层.

原文地址http://symfony.com/doc/current/bundles/FOSUserBundle/overriding_forms.html

重写表单类型

FOSUserBundle为新用户注册, 更新用户信息, 修改密码等功能封装了默认的表单. 这些表单能很好的作用在默认的类以及控制器上. 但假如你想在你的User类里面添加更多的属性, 或者想在注册表单里面添加一些选项时, 就得去修改默认的表单.

原文地址http://symfony.com/doc/current/bundles/FOSUserBundle/overriding_controllers.html

FOSUserBundle中默认的控制器提供了大量的功能来满足日常使用. 但在你的应用中, 通常需要继承这些功能, 并且在里面添加你自己的业务逻辑.

原文地址http://symfony.com/doc/current/bundles/FOSUserBundle/controller_events.html

通过FOSUserBundle包装过的控制器提供了一些能够满足一般需要的功能. 不过你可能需要在你的应用中扩展这些功能, 并且加入你自己的业务逻辑.

原文地址: http://symfony.com/doc/current/bundles/FOSUserBundle/overriding_templates.html

如果你在应用中使用了FOSUserBundle, 你势必会想办法去重写这个bundle提供的默认模板.
虽然模板的名称是不可配置的, 但是Symfony框架也为我们提供了两种重写模板的方式.

1. 在app/Resources文件夹中定义一个同名模板文件.
2. 创建一个继承了FOSUserBundle的bundle.