Security: Complex Access Controls with Expressions¶

In addition to a role like ROLE_ADMIN, the isGranted() method also accepts an Expression object:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

use Symfony\Component\ExpressionLanguage\Expression;
// ...

public function index()
{
    $this->denyAccessUnlessGranted(new Expression(
        '"ROLE_ADMIN" in roles or (not is_anonymous() and user.isSuperAdmin())'
    ));

    // ...
}

In this example, if the current user has ROLE_ADMIN or if the current user object's isSuperAdmin() method returns true, then access will be granted (note: your User object may not have an isSuperAdmin() method, that method is invented for this example).

This uses an expression and you can learn more about the expression language syntax, see The Expression Syntax.

Inside the expression, you have access to a number of variables:

user

The user object (or the string anon if you're not authenticated).

roles

The array of roles the user has, including from the role hierarchy but not including the IS_AUTHENTICATED_* attributes (see the functions below).

object

The object (if any) that's passed as the second argument to isGranted().

token

The token object.

trust_resolver

The AuthenticationTrustResolverInterface, object: you'll probably use the is_*() functions below instead.

Additionally, you have access to a number of functions inside the expression:

is_authenticated

Returns true if the user is authenticated via "remember-me" or authenticated "fully" - i.e. returns true if the user is "logged in".

is_anonymous

Equal to using IS_AUTHENTICATED_ANONYMOUSLY with the isGranted() function.

is_remember_me

Similar, but not equal to IS_AUTHENTICATED_REMEMBERED, see below.

is_fully_authenticated

Similar, but not equal to IS_AUTHENTICATED_FULLY, see below.

is_granted

Checks if the user has the given permission. Optionally accepts a second argument with the object where permission is checked on. It's equivalent to using the isGranted() method from the authorization checker service.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

use Symfony\Component\ExpressionLanguage\Expression;
use Symfony\Component\Security\Core\Authorization\AuthorizationCheckerInterface;
// ...

public function index(AuthorizationCheckerInterface $authorizationChecker)
{
    $access1 = $authorizationChecker->isGranted('IS_AUTHENTICATED_REMEMBERED');

    $access2 = $authorizationChecker->isGranted(new Expression(
        'is_remember_me() or is_fully_authenticated()'
    ));
}