Acl::translate() - Code Metrics - Inspection of "New `NATIVE_IN` DQL function #7636" - Ecodev/felix - Measure and Improve Code Quality continuously with Scrutinizer

Failed Conditions

Push — master ( 389cea...9cc91e )

by Adrien

created 2023-01-10 06:09 UTC

Acl::translate() A

↳ Parent: Acl

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	2
CRAP Score	1

Importance

Changes

Metric	Value
cc	1
eloc	1
nc	1
nop	2
dl	0
loc	3
ccs	2
cts	2
cp	1
crap	1
rs	10
c	0
b	0
f	0

<?php

declare(strict_types=1);

namespace Ecodev\Felix\Acl;

use Doctrine\Common\Util\ClassUtils;
use Ecodev\Felix\Model\CurrentUser;
use Ecodev\Felix\Model\Model;
use Exception;
use Laminas\Permissions\Acl\Assertion\AssertionInterface;
use Laminas\Permissions\Acl\Resource\ResourceInterface;
use Laminas\Permissions\Acl\Role\RoleInterface;

class Acl extends \Laminas\Permissions\Acl\Acl
{
    /**
     * The message explaining the last denial.
     */
    private ?string $message = null;

    /**
     * @var string[]
     */
    private array $reasons = [];

    private DebugAcl $debugAcl;

    /**
     * @var array<string, string>
     */
    private array $resourceTranslations = [];

    /**
     * @var array<string, string>
     */
    private array $privilegeTranslations = [];

    public function __construct()
    {
        $this->debugAcl = new DebugAcl();
    }

    public function addRole($role, $parents = null)
    {
        $this->debugAcl->addRole($role, $parents);

        return parent::addRole($role, $parents);
    }

    public function addResource($resource, $parent = null)
    {
        $this->debugAcl->addResource($resource, $parent);

        return parent::addResource($resource, $parent);
    }

    public function allow($roles = null, $resources = null, $privileges = null, ?AssertionInterface $assert = null)
    {
        $this->debugAcl->allow($roles, $resources, $privileges, $assert);

        return parent::allow($roles, $resources, $privileges, $assert);
    }

    public function deny($roles = null, $resources = null, $privileges = null, ?AssertionInterface $assert = null)
    {
        $this->debugAcl->deny($roles, $resources, $privileges, $assert);

        return parent::deny($roles, $resources, $privileges, $assert);
    }

    protected function createModelResource(string $class): ModelResource
    {
        $resource = new ModelResource($class);
        $this->addResource($resource);

        return $resource;
    }

    /**
     * Override parent to provide compatibility with MultipleRoles.
     *
     * @param null|RoleInterface|string $role
     * @param null|ResourceInterface|string $resource
     * @param null|string $privilege
     */
    public function isAllowed($role = null, $resource = null, $privilege = null): bool
    {
        // Normalize roles
        if ($role instanceof MultipleRoles) {
            $roles = $role->getRoles();
        } else {
            $roles = [$role];
        }

        // If at least one role is allowed, then return early
        foreach ($roles as $role) {
            if (parent::isAllowed($role, $resource, $privilege)) {
                return true;
            }
        }

        return false;
    }

    /**
     * Return whether the current user is allowed to do something.
     *
     * This should be the main method to do all ACL checks.
     */
    public function isCurrentUserAllowed(Model|string $modelOrResource, string $privilege): bool
    {
        $resource = is_string($modelOrResource) ? $modelOrResource : new ModelResource($this->getClass($modelOrResource), $modelOrResource);
        $role = $this->getCurrentRole();
        $this->reasons = [];

        $isAllowed = $this->isAllowed($role, $resource, $privilege);

        $this->message = $this->buildMessage($resource, $privilege, $role, $isAllowed);

        return $isAllowed;
    }

    /**
     * Set the reason for rejection that will be shown to end-user.
     *
     * This method always return false for usage convenience and should be used by all assertions,
     * instead of only return false themselves.
     *
     * @return false
     */
    public function reject(string $reason): bool
    {
        $this->reasons[] = $reason;

        return false;
    }

    private function getClass(Model $resource): string
    {
        return ClassUtils::getRealClass($resource::class);
    }

    private function getCurrentRole(): MultipleRoles|string
    {
        $user = CurrentUser::get();
        if (!$user) {
            return 'anonymous';
        }

        return $user->getRole();
    }

    private function buildMessage(ModelResource|string $resource, ?string $privilege, MultipleRoles|string $role, bool $isAllowed): ?string
    {
        if ($isAllowed) {
            return null;
        }

        if ($resource instanceof ModelResource) {
            $resource = $resource->getName();
        }

        $user = CurrentUser::get();
        $userName = $user ? 'User "' . $user->getLogin() . '"' : 'Non-logged user';
        $privilege ??= 'NULL';

        $message = "$userName with role $role is not allowed on resource \"$resource\" with privilege \"$privilege\"";

        $this->reasons = array_unique($this->reasons);
        $count = count($this->reasons);
        if ($count === 1) {
            $message .= ' because ' . $this->reasons[0];
        } elseif ($count) {
            $list = array_map(fn ($reason) => '- ' . $reason, $this->reasons);
            $message .= ' because:' . PHP_EOL . PHP_EOL . implode(PHP_EOL, $list);
        }

        return $message;
    }

    /**
     * Returns the message explaining the last denial, if any.
     */
    public function getLastDenialMessage(): ?string
    {
        return $this->message;
    }

    /**
     * Show the ACL configuration for the given role in a structured array.
     *
     * @return array<array{resource:string, privileges: array<int, array{privilege:null|string, allowed: bool, allowIf: string[], denyIf: string[]}>}>
     */
    public function show(MultipleRoles|string $role, bool $useTranslations = true): array
    {
        $result = [];
        /** @var string[] $resources */
        $resources = $this->getResources();
        sort($resources);

        foreach ($resources as $resource) {
            $privileges = [];
            foreach ($this->debugAcl->getPrivileges() as $privilege) {
                $privileges[] = $this->debugAcl->show($role, $resource, $privilege);
            }

            $result[] = [
                'resource' => $resource,
                'privileges' => $privileges,
            ];
        }

        ksort($result);

        if ($useTranslations && ($this->resourceTranslations || $this->privilegeTranslations)) {
            foreach ($result as &$resource) {
                $resource['resource'] = $this->translate($this->resourceTranslations, $resource['resource']);
                foreach ($resource['privileges'] as &$privilege) {
                    $privilege['privilege'] = $this->translate($this->privilegeTranslations, $privilege['privilege'] ?? '');
                }
            }
        }

        return $result;
    }

    /**
     * Configure the translations for all resources and all privileges for the `show()` method.
     *
     * If this is set but one translation is missing, then `show()` will throw an exception when called.
     *
     * To disable translation altogether you can pass two empty lists.
     *
     * @param array<string, string> $resourceTranslations
     * @param array<string, string> $privilegeTranslations
     */
    public function setTranslations(array $resourceTranslations, array $privilegeTranslations): void
    {
        $this->resourceTranslations = $resourceTranslations;
        $this->privilegeTranslations = $privilegeTranslations;
    }

    /**
     * @param array<string, string> $translations
     */
    private function translate(array $translations, string $message): string
    {
        return $translations[$message] ?? throw new Exception('Was not marked as translatable: ' . $message);
    }

    /**
     * Returns all non-null privileges indexed by all non-null resources.
     *
     * @return array<string, array<string>>
     */
    public function getPrivilegesByResource(): array
    {
        return $this->debugAcl->getPrivilegesByResource();
    }
}


1		<?php
2
3		declare(strict_types=1);
4
5		namespace Ecodev\Felix\Acl;
6
7		use Doctrine\Common\Util\ClassUtils;
8		use Ecodev\Felix\Model\CurrentUser;
9		use Ecodev\Felix\Model\Model;
10		use Exception;
11		use Laminas\Permissions\Acl\Assertion\AssertionInterface;
12		use Laminas\Permissions\Acl\Resource\ResourceInterface;
13		use Laminas\Permissions\Acl\Role\RoleInterface;
14
15		class Acl extends \Laminas\Permissions\Acl\Acl
16		{
17		/**
18		* The message explaining the last denial.
19		*/
20		private ?string $message = null;
21
22		/**
23		* @var string[]
24		*/
25		private array $reasons = [];
26
27		private DebugAcl $debugAcl;
28
29		/**
30		* @var array<string, string>
31		*/
32		private array $resourceTranslations = [];
33
34		/**
35		* @var array<string, string>
36		*/
37		private array $privilegeTranslations = [];
38
39	8	public function __construct()
40		{
41	8	$this->debugAcl = new DebugAcl();
42		}
43
44	8	public function addRole($role, $parents = null)
45		{
46	8	$this->debugAcl->addRole($role, $parents);
47
48	8	return parent::addRole($role, $parents);
49		}
50
51	8	public function addResource($resource, $parent = null)
52		{
53	8	$this->debugAcl->addResource($resource, $parent);
54
55	8	return parent::addResource($resource, $parent);
56		}
57
58	8	public function allow($roles = null, $resources = null, $privileges = null, ?AssertionInterface $assert = null)
59		{
60	8	$this->debugAcl->allow($roles, $resources, $privileges, $assert);
61
62	8	return parent::allow($roles, $resources, $privileges, $assert);
63		}
64
65		public function deny($roles = null, $resources = null, $privileges = null, ?AssertionInterface $assert = null)
66		{
67		$this->debugAcl->deny($roles, $resources, $privileges, $assert);
68
69		return parent::deny($roles, $resources, $privileges, $assert);
70		}
71
72	4	protected function createModelResource(string $class): ModelResource
73		{
74	4	$resource = new ModelResource($class);
75	4	$this->addResource($resource);
76
77	4	return $resource;
78		}
79
80		/**
81		* Override parent to provide compatibility with MultipleRoles.
82		*
83		* @param null\|RoleInterface\|string $role
84		* @param null\|ResourceInterface\|string $resource
85		* @param null\|string $privilege
86		*/
87	5	public function isAllowed($role = null, $resource = null, $privilege = null): bool
88		{
89		// Normalize roles
90	5	if ($role instanceof MultipleRoles) {
91	1	$roles = $role->getRoles();
92		} else {
93	4	$roles = [$role];
94		}
95
96		// If at least one role is allowed, then return early
97	5	foreach ($roles as $role) {
98	5	if (parent::isAllowed($role, $resource, $privilege)) {
99	1	return true;
100		}
101		}
102
103	5	return false;
104		}
105
106		/**
107		* Return whether the current user is allowed to do something.
108		*
109		* This should be the main method to do all ACL checks.
110		*/
111	5	public function isCurrentUserAllowed(Model\|string $modelOrResource, string $privilege): bool
112		{
113	5	$resource = is_string($modelOrResource) ? $modelOrResource : new ModelResource($this->getClass($modelOrResource), $modelOrResource);
114	5	$role = $this->getCurrentRole();
115	5	$this->reasons = [];
116
117	5	$isAllowed = $this->isAllowed($role, $resource, $privilege);
118
119	5	$this->message = $this->buildMessage($resource, $privilege, $role, $isAllowed);
120
121	5	return $isAllowed;
122		}
123
124		/**
125		* Set the reason for rejection that will be shown to end-user.
126		*
127		* This method always return false for usage convenience and should be used by all assertions,
128		* instead of only return false themselves.
129		*
130		* @return false
131		*/
132	4	public function reject(string $reason): bool
133		{
134	4	$this->reasons[] = $reason;
135
136	4	return false;
137		}
138
139	4	private function getClass(Model $resource): string
140		{
141	4	return ClassUtils::getRealClass($resource::class);
142		}
143
144	5	private function getCurrentRole(): MultipleRoles\|string
145		{
146	5	$user = CurrentUser::get();
147	5	if (!$user) {
148	2	return 'anonymous';
149		}
150
151	4	return $user->getRole();
152		}
153
154	5	private function buildMessage(ModelResource\|string $resource, ?string $privilege, MultipleRoles\|string $role, bool $isAllowed): ?string
155		{
156	5	if ($isAllowed) {
157	1	return null;
158		}
159
160	5	if ($resource instanceof ModelResource) {
161	4	$resource = $resource->getName();
162		}
163
164	5	$user = CurrentUser::get();
165	5	$userName = $user ? 'User "' . $user->getLogin() . '"' : 'Non-logged user';
166	5	$privilege ??= 'NULL';
167
168	5	$message = "$userName with role $role is not allowed on resource \"$resource\" with privilege \"$privilege\"";
169
170	5	$this->reasons = array_unique($this->reasons);
171	5	$count = count($this->reasons);
172	5	if ($count === 1) {
173	3	$message .= ' because ' . $this->reasons[0];
174	3	} elseif ($count) {
175	1	$list = array_map(fn ($reason) => '- ' . $reason, $this->reasons);
176	1	$message .= ' because:' . PHP_EOL . PHP_EOL . implode(PHP_EOL, $list);
177		}
178
179	5	return $message;
180		}
181
182		/**
183		* Returns the message explaining the last denial, if any.
184		*/
185	5	public function getLastDenialMessage(): ?string
186		{
187	5	return $this->message;
188		}
189
190		/**
191		* Show the ACL configuration for the given role in a structured array.
192		*
193		* @return array<array{resource:string, privileges: array<int, array{privilege:null\|string, allowed: bool, allowIf: string[], denyIf: string[]}>}>
194		*/
195	2	public function show(MultipleRoles\|string $role, bool $useTranslations = true): array
196		{
197	2	$result = [];
198		/** @var string[] $resources */
199	2	$resources = $this->getResources();
200	2	sort($resources);
201
202	2	foreach ($resources as $resource) {
203	2	$privileges = [];
204	2	foreach ($this->debugAcl->getPrivileges() as $privilege) {
205	2	$privileges[] = $this->debugAcl->show($role, $resource, $privilege);
206		}
207
208	2	$result[] = [
209	2	'resource' => $resource,
210	2	'privileges' => $privileges,
211	2	];
212		}
213
214	2	ksort($result);
215
216	2	if ($useTranslations && ($this->resourceTranslations \|\| $this->privilegeTranslations)) {
217	2	foreach ($result as &$resource) {
218	2	$resource['resource'] = $this->translate($this->resourceTranslations, $resource['resource']);
219	2	foreach ($resource['privileges'] as &$privilege) {
220	2	$privilege['privilege'] = $this->translate($this->privilegeTranslations, $privilege['privilege'] ?? '');
221		}
222		}
223		}
224
225	1	return $result;
226		}
227
228		/**
229		* Configure the translations for all resources and all privileges for the `show()` method.
230		*
231		* If this is set but one translation is missing, then `show()` will throw an exception when called.
232		*
233		* To disable translation altogether you can pass two empty lists.
234		*
235		* @param array<string, string> $resourceTranslations
236		* @param array<string, string> $privilegeTranslations
237		*/
238	2	public function setTranslations(array $resourceTranslations, array $privilegeTranslations): void
239		{
240	2	$this->resourceTranslations = $resourceTranslations;
241	2	$this->privilegeTranslations = $privilegeTranslations;
242		}
243
244		/**
245		* @param array<string, string> $translations
246		*/
247	2	private function translate(array $translations, string $message): string
248		{
249	2	return $translations[$message] ?? throw new Exception('Was not marked as translatable: ' . $message);
250		}
251
252		/**
253		* Returns all non-null privileges indexed by all non-null resources.
254		*
255		* @return array<string, array<string>>
256		*/
257	1	public function getPrivilegesByResource(): array
258		{
259	1	return $this->debugAcl->getPrivilegesByResource();
260		}
261		}
262

Ecodev / felix

Push — master ( 389cea...9cc91e )

Acl::translate() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like