project-a/acl-bundle

Providing an easy way to work with the Symfony Security Acl.

ChiliLabs AclBundle

Bundle for Symfony2 providing easy access to the complex ACL subsystem

, _(*1)

Description

This Symfony 2 Bundle provides an easy api to the Security/ACL component and an eventlistener for automatic ACL cleanup upon removal of domain objects. The installation is simple and by default does not change any behavior of your application., _(*2)

Without this bundle you normally do this (taken from the [ACL docs][1]):, _(*3)

// creating the ACL
$aclProvider = $container->get('security.acl.provider');
$objectIdentity = ObjectIdentity::fromDomainObject($domainObject);
$acl = $aclProvider->createAcl($objectIdentity);

// retrieving the security identity of the currently logged-in user
$tokenStorage = $container->get('security.token_storage');
$user = $tokenStorage->getToken()->getUser();
$securityIdentity = UserSecurityIdentity::fromAccount($user);

// grant owner access
$acl->insertObjectAce($securityIdentity, MaskBuilder::MASK_OWNER);
$aclProvider->updateAcl($acl);

With this bundle you can simplify it to:, _(*4)

$tokenStorage = $container->get('security.token_storage');
$user = $tokenStorage->getToken()->getUser();

$aclManager = $container->get('projecta_acl.manager');
$aclManager->manageObjectAces()
    ->grant($domainObject, MaskBuilder::MASK_OWNER, $user);

Documentation

The latest documentation can be found on aclbundle.chililabs.org., _(*5)

Tests

To run the test suite, you need composer., _(*6)

$ composer install
$ phpunit

License

ChiliLabs AclBundle is licensed under the MIT license., _(*7)