PHPackages                             felipe-etec/simple-php-acl - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. felipe-etec/simple-php-acl

ActiveLibrary[Authentication & Authorization](/categories/authentication)

felipe-etec/simple-php-acl
==========================

Um sistema simples e eficiente de controle de acesso (ACL) baseado em papéis (roles) e permissões usando PDO e PHP.

00PHP

Since Jun 29Pushed 1mo agoCompare

[ Source](https://github.com/felipecarvalho-back/sitema-acl)[ Packagist](https://packagist.org/packages/felipe-etec/simple-php-acl)[ RSS](/packages/felipe-etec-simple-php-acl/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Simple PHP ACL
==============

[](#simple-php-acl)

Um pacote PHP simples, elegante e eficiente para controle de acesso baseado em funções (Roles) e permissões (Permissions) usando PDO.

Requisitos
----------

[](#requisitos)

- PHP >= 7.4
- Banco de dados MySQL ou qualquer banco de dados compatível com PDO

Instalação
----------

[](#instalação)

Adicione o repositório ou instale localmente via Composer:

```
composer require felipe-etec/simple-php-acl
```

Configuração do Banco de Dados
------------------------------

[](#configuração-do-banco-de-dados)

Você tem duas formas de configurar as tabelas do banco de dados no seu projeto:

### Opção 1: Criação Automática (Recomendada)

[](#opção-1-criação-automática-recomendada)

Você pode chamar o método estático `createTables` logo após instanciar a conexão PDO (por exemplo, em um script de instalação ou migration):

```
use FelipeEtec\SimpleAcl\ACL;

$pdo = new PDO("mysql:host=localhost;dbname=seu_banco", "usuario", "senha");

// Cria todas as tabelas necessárias automaticamente
ACL::createTables($pdo);
```

### Opção 2: SQL Manual

[](#opção-2-sql-manual)

Se preferir, crie as tabelas manualmente rodando este script SQL:

```
CREATE TABLE `users` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `name` VARCHAR(100) NOT NULL,
    `email` VARCHAR(100) UNIQUE NOT NULL,
    `password` VARCHAR(255) NOT NULL,
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE `roles` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `name` VARCHAR(50) UNIQUE NOT NULL,
    `description` VARCHAR(255) NULL
);

CREATE TABLE `permissions` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `name` VARCHAR(100) UNIQUE NOT NULL,
    `description` VARCHAR(255) NULL
);

CREATE TABLE `role_permissions` (
    `role_id` INT,
    `permission_id` INT,
    PRIMARY KEY (`role_id`, `permission_id`),
    FOREIGN KEY (`role_id`) REFERENCES `roles`(`id`) ON DELETE CASCADE,
    FOREIGN KEY (`permission_id`) REFERENCES `permissions`(`id`) ON DELETE CASCADE
);

CREATE TABLE `user_roles` (
    `user_id` INT,
    `role_id` INT,
    PRIMARY KEY (`user_id`, `role_id`),
    FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON DELETE CASCADE,
    FOREIGN KEY (`role_id`) REFERENCES `roles`(`id`) ON DELETE CASCADE
);
```

Como Usar
---------

[](#como-usar)

### 1. Validando Permissões e Funções

[](#1-validando-permissões-e-funções)

```
use FelipeEtec\SimpleAcl\ACL;

$acl = new ACL($pdo, $userId);

// Verificar permissão
if ($acl->hasPermission('excluir_conteudo')) {
    // Ação autorizada
}

// Verificar função
if ($acl->hasRole('Administrador')) {
    // Painel administrativo
}
```

### 2. Gerenciando Funções e Permissões (Dar e Revogar Acesso)

[](#2-gerenciando-funções-e-permissões-dar-e-revogar-acesso)

O pacote oferece métodos robustos para administrar funções e permissões programaticamente:

```
// 1. Criar uma nova função e uma permissão
$roleId = $acl->createRole('Editor Senior', 'Pode revisar e publicar artigos');
$permissionId = $acl->createPermission('publicar_artigo', 'Permissão para publicar artigos');

// 2. Associar a permissão a esta função
$acl->addPermissionToRole($roleId, $permissionId);

// 3. Atribuir a função a um usuário
$acl->assignRoleToUser($userId, $roleId);

// 4. Revogar papel ou permissão
$acl->removeRoleFromUser($userId, $roleId);
$acl->removePermissionFromRole($roleId, $permissionId);
```

Licença
-------

[](#licença)

Este projeto está licenciado sob a licença MIT.

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance60

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/02a4be16841d7f64b1aa589579da01c19b5bbaa186ea1b224b63c552b8af9d5d?d=identicon)[felipecarvalho-back](/maintainers/felipecarvalho-back)

---

Top Contributors

[![felipecarvalho-back](https://avatars.githubusercontent.com/u/288696517?v=4)](https://github.com/felipecarvalho-back "felipecarvalho-back (1 commits)")

### Embed Badge

![Health badge](/badges/felipe-etec-simple-php-acl/health.svg)

```
[![Health](https://phpackages.com/badges/felipe-etec-simple-php-acl/health.svg)](https://phpackages.com/packages/felipe-etec-simple-php-acl)
```

###  Alternatives

[vitalybaev/laravel5-dkim

Laravel 5/6 package for signing outgoing messages with DKIM.

3163.1k](/packages/vitalybaev-laravel5-dkim)[firemultimedia/mautic-multi-captcha-bundle

This plugin brings Google's reCAPTCHA, hCaptcha, and Cloudflare Turnstile integration to mautic.

151.4k](/packages/firemultimedia-mautic-multi-captcha-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)