README

Suporte a Multi-Tenancy para módulos CodeIgniter 4. Permite isolar dados e configurações por cliente (tenant) de forma automática.

📋 Características

✅ Detecção Automática - Detecta o tenant via Subdomínio, Header HTTP ou Sessão
✅ Global Context - Acesso fácil ao tenant atual em qualquer lugar do app
✅ Filtro Nativo - Integração direta com filtros do CI4 para segurança
✅ Helper Functions - Funções tenant() e has_tenant()
✅ Configurável - Fácil de estender e adaptar ao seu modelo de banco

🚀 Instalação

composer require rahpt/ci4-module-tenancy

📖 Uso Básico

1. Configuração

Publique o arquivo de configuração para app/Config/Tenancy.php:

<?php

namespace Config;

use Rahpt\Ci4ModuleTenancy\Config\Tenancy as BaseTenancy;

class Tenancy extends BaseTenancy
{
    public string $detectionMode = 'subdomain'; // 'subdomain', 'header' ou 'session'
    public string $detectionKey  = '0';         // Índice do subdomínio
    public bool   $requireTenant = true;       // Bloqueia acesso sem tenant
}

2. Ativar o Filtro

O pacote registra automaticamente o alias tenant. Adicione-o ao seu app/Config/Filters.php:

public array $globals = [
    'before' => [
        'tenant', // Ativa detecção em todas as rotas
    ],
];

3. Usando no Código

// Obter o ID do tenant atual
$tenantId = tenant();

if (has_tenant()) {
    echo "Logado na empresa: " . $tenantId;
}

// Exemplo em um Model
public function getItems()
{
    return $this->where('tenant_id', tenant())->findAll();
}

🧪 Métodos de Detecção

Subdomínio

Se o app estiver em cliente1.meuapp.com, o tenant será cliente1.

Header HTTP

Útil para APIs. Envie o header X-Tenant-ID: cliente1.

Sessão

Útil se o tenant for escolhido após o login. Salve tenant_id na sessão.

🕒 Histórico de Versões

[1.1.0] - 2026-02-16

Arquitetura: Refatoração do TenantContext para o namespace raiz do pacote.
Testes: Adição de suíte de testes unitários para validação de contexto.
Padronização: Alinhamento com o ecossistema Rahpt v1.1.0.

[1.0.1] - 2026-02-15

Versão inicial com detecção tripla (subdomain, header, session).

📄 Licença

MIT License

👏 Créditos

Desenvolvido por Rahpt

Versão: 1.1.0
Última Atualização: 2026-02-16

rahpt / ci4-module-tenancy

Maintainers

Details