PermissionName

Normalizes controller and action names used by ACL permissions.

Public routes often use dash-case while PHP actions use camelCase methods. This helper gives permission config, attributes, dispatcher security, and behavior attachment one shared vocabulary: component checks prefer the real handler class and action checks canonicalize to dash-case while retaining raw aliases for backwards compatibility.

• Full name: \PhalconKit\Acl\PermissionName
• This class is marked as final and can't be subclassed
• This class is a Final class

Methods

action

Normalize a dispatcher or method action name into the ACL action key.

public static action(string $action): string

Examples:

• findWith becomes find-with
• find-with remains find-with

• findWithAction becomes find-with

• This method is static. Parameters:

Return Value:

Dash-case ACL action key, *, or an empty string.

actionCandidates

Return action aliases to try for a dispatcher action.

public static actionCandidates(string $action): array<int,string>

The canonical dash-case action is first so new config and attributes take precedence. The raw action follows so older camelCase permission configs remain valid during migration.

• This method is static. Parameters:

Return Value:

Unique action candidates.

accessList

Normalize a public action list for native Phalcon ACL registration.

public static accessList(mixed $accessList): array<int,string>

Raw camelCase entries are preserved and dash-case aliases are added. This keeps direct Acl::isAllowed(..., 'findWith') callers compatible while allowing dispatcher security to check canonical dash-case actions.

• This method is static. Parameters:

Return Value:

ACL access names.

actionFromMethod

Derive a canonical action key from an action method name.

public static actionFromMethod(string $methodName): string

• This method is static. Parameters:

Return Value:

Dash-case ACL action key.

handlerCandidates

Build component aliases for the active controller or task.

public static handlerCandidates(string $handlerClass, string|null $routeName = null, string $suffix = 'Controller'): array<int,string>

The fully qualified handler class remains the preferred component key. Short class names and route-style aliases are accepted so existing apps can gradually move from route names such as project-user to class constants.

• This method is static. Parameters:

Return Value:

Unique component candidates.

normalizeAttributeActions

Normalize a method/class attribute action list.

public static normalizeAttributeActions(array<int,string>|null $actions, array<int,string> $defaultActions): array<int,string>

• This method is static. Parameters:

Return Value:

Canonical dash-case action keys.

dash

Convert camelCase, PascalCase, snake_case, or spaced names to dash-case.

private static dash(string $name): string

• This method is static. Parameters:

unique

private static unique(array $values): array<int,string>

• This method is static. Parameters:

shortClass

private static shortClass(string $className): string

• This method is static. Parameters:

withoutSuffix

private static withoutSuffix(string $name, string $suffix): string

• This method is static. Parameters: