Ecodev / felix

src/Acl/MultipleRoles.php

<?php

declare(strict_types=1);

namespace Ecodev\Felix\Acl;

use Exception;
use Laminas\Permissions\Acl\Role\RoleInterface;
use Stringable;

/**
 * A role containing multiple roles.
 */
class MultipleRoles implements RoleInterface, Stringable
{
    /**
     * @var string[]
     */
    private array $roles = [];

    /**
     * @param string[] $roles
     */
    public function __construct(array $roles = [])
    {
        foreach ($roles as $role) {
            $this->addRole($role);
        }
    }

    /**
     * Add a role to the list.
     */
    public function addRole(string $role): void
    {
        $this->roles[] = $role;

        $this->roles = array_unique($this->roles);
        sort($this->roles);
    }

    public function getRoleId(): never

The type Ecodev\Felix\Acl\never was not found. Maybe you did not declare it correctly or list all dependencies?

    {
        throw new Exception('This should never be called. If it is, then it means this class is not used correctly');
    }

    /**
     * Return the role list.
     *
     * @return string[]
     */
    public function getRoles(): array
    {
        return $this->roles;
    }

    /**
     * Return whether the given role is included in the list.
     */
    public function has(string $role): bool
    {
        return in_array($role, $this->roles, true);
    }

    public function __toString(): string
    {
        return '[' . implode(', ', $this->roles) . ']';
    }
}