/**
 * Access Granted
 *
 * @var bool
 */
protected accessGranted = false;

/**
 * Active access which the list is checking if some role can access it
 *
 * @var string|null
 */
protected activeAccess;

/**
 * Component which the list is checking if some role can access it
 *
 * @var string|null
 */
protected activeComponent;

/**
 * Role which the list is checking if it's allowed to certain
 * component/access
 *
 * @var string|null
 */
protected activeRole;

/**
 * Default access
 *
 * @var int
 */
protected defaultAccess;

public function getActiveAccess(): string | null;

public function getActiveComponent(): string | null;

public function getActiveRole(): string | null;

public function getDefaultAction(): int;

public function setDefaultAction( int $defaultAccess ): void;

public function addComponent( mixed $componentValue, mixed $accessList ): bool;

public function addComponentAccess( string $componentName, mixed $accessList ): bool;

public function addInherit( string $roleName, mixed $roleToInherits ): bool;

public function addRole( mixed $role, mixed $accessInherits = null ): bool;

public function allow( string $roleName, string $componentName, mixed $access, mixed $func = null ): void;

public function deny( string $roleName, string $componentName, mixed $access, mixed $func = null ): void;

public function dropComponentAccess( string $componentName, mixed $accessList ): void;

public function getActiveAccess(): null | string;

public function getActiveComponent(): null | string;

public function getActiveRole(): null | string;

public function getComponents(): ComponentInterface[];

public function getDefaultAction(): int;

public function getInheritedRoles( string $roleName = string ): array;

public function getNoArgumentsDefaultAction(): int;

public function getRoles(): RoleInterface[];

public function isAllowed( mixed $roleName, mixed $componentName, string $access, array $parameters = null ): bool;

public function isComponent( string $componentName ): bool;

public function isRole( string $roleName ): bool;

public function setDefaultAction( int $defaultAccess ): void;

public function setNoArgumentsDefaultAction( int $defaultAccess ): void;

$acl = new \Phalcon\Acl\Adapter\Memory();

$acl->setDefaultAction(
    \Phalcon\Acl\Enum::DENY
);

// Register roles
$roles = [
    "users"  => new \Phalcon\Acl\Role("Users"),
    "guests" => new \Phalcon\Acl\Role("Guests"),
];
foreach ($roles as $role) {
    $acl->addRole($role);
}

// Private area components
$privateComponents = [
    "companies" => ["index", "search", "new", "edit", "save", "create", "delete"],
    "products"  => ["index", "search", "new", "edit", "save", "create", "delete"],
    "invoices"  => ["index", "profile"],
];

foreach ($privateComponents as $componentName => $actions) {
    $acl->addComponent(
        new \Phalcon\Acl\Component($componentName),
        $actions
    );
}

// Public area components
$publicComponents = [
    "index"   => ["index"],
    "about"   => ["index"],
    "session" => ["index", "register", "start", "end"],
    "contact" => ["index", "send"],
];

foreach ($publicComponents as $componentName => $actions) {
    $acl->addComponent(
        new \Phalcon\Acl\Component($componentName),
        $actions
    );
}

// Grant access to public areas to both users and guests
foreach ($roles as $role) {
    foreach ($publicComponents as $component => $actions) {
        $acl->allow($role->getName(), $component, "*");
    }
}

// Grant access to private area to role Users
foreach ($privateComponents as $component => $actions) {
    foreach ($actions as $action) {
        $acl->allow("Users", $component, $action);
    }
}

/**
 * Access
 *
 * @var mixed
 */
protected access;

/**
 * Access List
 *
 * @var mixed
 */
protected accessList;

/**
 * Returns the latest function used to acquire access
 *
 * @var mixed
 */
protected activeFunction;

/**
 * Returns number of additional arguments(excluding role and resource) for active function
 *
 * @var int
 */
protected activeFunctionCustomArgumentsCount = 0;

/**
 * Returns the latest key used to acquire access
 *
 * @var string|null
 */
protected activeKey;

/**
 * Components
 *
 * @var mixed
 */
protected components;

/**
 * Component Names
 *
 * @var mixed
 */
protected componentsNames;

/**
 * Function List
 *
 * @var mixed
 */
protected func;

/**
 * Default action for no arguments is `allow`
 *
 * @var mixed
 */
protected noArgumentsDefaultAction;

/**
 * Roles
 *
 * @var mixed
 */
protected roles;

/**
 * Role Inherits
 *
 * @var mixed
 */
protected roleInherits;

public function __construct();

public function addComponent( mixed $componentValue, mixed $accessList ): bool;

// Add a component to the list allowing access to an action
$acl->addComponent(
    new Phalcon\Acl\Component("customers"),
    "search"
);

$acl->addComponent("customers", "search");

// Add a component  with an access list
$acl->addComponent(
    new Phalcon\Acl\Component("customers"),
    [
        "create",
        "search",
    ]
);

$acl->addComponent(
    "customers",
    [
        "create",
        "search",
    ]
);

public function addComponentAccess( string $componentName, mixed $accessList ): bool;

public function addInherit( string $roleName, mixed $roleToInherits ): bool;

$acl->addRole("administrator", "consultant");
$acl->addRole("administrator", ["consultant", "consultant2"]);

public function addRole( mixed $role, mixed $accessInherits = null ): bool;

$acl->addRole(
    new Phalcon\Acl\Role("administrator"),
    "consultant"
);

$acl->addRole("administrator", "consultant");
$acl->addRole("administrator", ["consultant", "consultant2"]);

public function allow( string $roleName, string $componentName, mixed $access, mixed $func = null ): void;

// Allow access to guests to search on customers
$acl->allow("guests", "customers", "search");

// Allow access to guests to search or create on customers
$acl->allow("guests", "customers", ["search", "create"]);

// Allow access to any role to browse on products
$acl->allow("*", "products", "browse");

// Allow access to any role to browse on any component
$acl->allow("*", "*", "browse");


```php
public function deny( string $roleName, string $componentName, mixed $access, mixed $func = null ): void;

// Deny access to guests to search on customers
$acl->deny("guests", "customers", "search");

// Deny access to guests to search or create on customers
$acl->deny("guests", "customers", ["search", "create"]);

// Deny access to any role to browse on products
$acl->deny("*", "products", "browse");

// Deny access to any role to browse on any component
$acl->deny("*", "*", "browse");

public function dropComponentAccess( string $componentName, mixed $accessList ): void;

public function getActiveFunction(): mixed;

public function getActiveFunctionCustomArgumentsCount(): int;

public function getActiveKey(): string | null;

public function getComponents(): ComponentInterface[];

public function getInheritedRoles( string $roleName = string ): array;

public function getNoArgumentsDefaultAction(): int;

public function getRoles(): RoleInterface[];

public function isAllowed( mixed $roleName, mixed $componentName, string $access, array $parameters = null ): bool;

// Does andres have access to the customers component to create?
$acl->isAllowed("andres", "Products", "create");

// Do guests have access to any component to edit?
$acl->isAllowed("guests", "*", "edit");

public function isComponent( string $componentName ): bool;

public function isRole( string $roleName ): bool;

public function setNoArgumentsDefaultAction( int $defaultAccess ): void;

/**
 * Component description
 *
 * @var string
 */
private description;

/**
 * Component name
 *
 * @var string
 */
private name;

public function __construct( string $name, string $description = null );

public function __toString(): string;

public function getDescription(): string;

public function getName(): string;

public function getComponentName(): string;

public function __toString(): string;

public function getDescription(): string;

public function getName(): string;

const ALLOW = 1;
const DENY = 0;

/**
 * Role description
 *
 * @var string
 */
private description;

/**
 * Role name
 *
 * @var string
 */
private name;

public function __construct( string $name, string $description = null );

public function __toString(): string;

public function getDescription(): string;

public function getName(): string;

public function getRoleName(): string;

public function __toString(): string;

public function getDescription(): string;

public function getName(): string;