linkorb/userbase-role-provider-bundle

Userbase Role Provider Bundle for modern Symfony Applications

v1.0.1 2019-07-02 14:59 UTC

README

Userbase Role Provider Bundle

Use this bundle to add Roles to Users loaded by the UserProvider.

Userbase does not provide Role information about its users so apps need to supply their own. This bundle allows you to define fixed roles for your users and these will be incorporated into the User objects loaded by the Userbase UserProvider.

Define the fixed roles in a Yaml file at config/roles.yaml:-

my-username: [ROLE_ADMIN]
some-other-username: [ROLE_USER]

That's it! You can now restrict access to resources based on these roles.

Installation

Note: this feature requires version 1.7 or later of the userbase/client package. You may need to begin installation by issuing:-

$ composer require "linkorb/userbase-client ^1.7"

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

$ composer require linkorb/userbase-role-provider-bundle

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

$ composer require linkorb/userbase-role-provider-bundle

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the config/bundles.php file of your project:

// config/bundles.php

return [
    // ...
    LinkORB\Userbase\RoleProvider\UserbaseRoleProviderBundle::class => ['all' => true],
];