ENUM (Lista Fechada de Opções)
⭐ Essencial 💾 1 Byte (até 255 opções) ou 2 Bytes (até 65.535 opções)Permite que a coluna assuma apenas UM valor dentre uma lista pré-definida de opções.
Internamente no MySQL, o ENUM armazena o texto das opções no metadado da tabela e grava apenas um índice numérico compacto de 1 byte na linha (para até 255 opções), mas exibe e filtra como string. No PHP 8.1+, combina perfeitamente com `BackedEnum`. Alternativamente, em sistemas onde a lista de opções muda com frequência, muitos arquitetos preferem `VARCHAR(30)` validado por um `enum` do PHP ou uma tabela de domínio auxiliar.
Limites de Capacidade: 1 valor escolhido por registro dentre a lista declarada
✅ Quando Usar (Casos Ideais)
- • Status de máquina de estados estável: `ENUM('pendente', 'pago', 'enviado', 'cancelado')`.
- • Tipo de pessoa: `ENUM('PF', 'PJ')`.
- • Nível de severidade de um log: `ENUM('info', 'warning', 'error', 'critical')`.
🚫 Quando NÃO Usar (Armadilhas)
- • Listas que o administrador do sistema pode cadastrar ou editar pelo painel (ex: categorias de produtos, cargos da empresa) — para isso, crie uma tabela separada com Foreign Key!
📐 Como Configurar no DrawDB Abrir DrawDB ↗
Type no DrawDB:
ENUM
Size / Values:
'pendente', 'pago', 'enviado', 'cancelado'
Default sugerido:
'pendente'
Equivalência nos Dialetos do DrawDB:
MySQL / MariaDB
ENUM('pendente', 'pago', 'cancelado') NOT NULL DEFAULT 'pendente'
PostgreSQL
CREATE TYPE status_pedido AS ENUM (...) ou VARCHAR(20) CHECK (...)
SQLite
TEXT CHECK(status IN ('pendente', 'pago', 'cancelado'))
📋 Exemplos Reais de Colunas com ENUM:
status
ENUM('pendente', 'pago', 'cancelado') NOT NULL DEFAULT 'pendente'
Ciclo de vida de um pedido
tipo_pessoa
ENUM('PF', 'PJ') NOT NULL
Pessoa Física ou Jurídica
🗄️ SQL DDL (Importar no DrawDB: Import > SQL)
CREATE TABLE pagamentos (
id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
pedido_id BIGINT UNSIGNED NOT NULL,
metodo ENUM('pix', 'cartao_credito', 'boleto') NOT NULL,
status ENUM('aguardando', 'aprovado', 'recusado', 'estornado') NOT NULL DEFAULT 'aguardando'
);
🐘 Como Validar e Salvar no PHP 8 + PDO
<?php
declare(strict_types=1);
// Usando Backed Enum nativo do PHP 8.1+ sincronizado com o banco!
enum StatusPagamento: string {
case Aguardando = 'aguardando';
case Aprovado = 'aprovado';
case Recusado = 'recusado';
case Estornado = 'estornado';
}
// Validando uma string recebida via requisição com tryFrom()
$statusRecebido = StatusPagamento::tryFrom($_POST['status'] ?? 'aguardando');
if ($statusRecebido === null) {
throw new ValueError('Status de pagamento inválido.');
}
$stmt = $pdo->prepare('
INSERT INTO pagamentos (pedido_id, metodo, status)
VALUES (:pedido_id, :metodo, :status)
');
$stmt->bindValue(':pedido_id', 1020, PDO::PARAM_INT);
$stmt->bindValue(':metodo', 'pix', PDO::PARAM_STR);
$stmt->bindValue(':status', $statusRecebido->value, PDO::PARAM_STR);
$stmt->execute();