README

Uma biblioteca PHP simples e elegante para gerenciar conexões de banco de dados com paginação automática.

Características

• Inicialização automática - Uma linha configura tudo
• Seguro - Prepared statements e validação
• Paginação elegante - Sistema completo de paginação
• Sintaxe de objeto - $data->total em vez de $data['total']
• PHP 7.4+ - Tipagem forte e recursos modernos

Instalação

composer require thiagowip/simple-database-manager

Configuração

Crie um arquivo .env na raiz do projeto:

DB_HOST=127.0.0.1
DB_USER=root
DB_PASS=
DB_NAME=your_database

Uso Básico

Inicialização

<?php
require 'vendor/autoload.php';

use ThiagoWip\SimpleDatabaseManager\App;

// Carrega .env, conecta banco e inicializa tudo automaticamente
$app = App::boot();

CRUD Simples

$db = $app->getDatabase();

// Inserir
$db->insert('users', ['name' => 'João', 'email' => 'joao@email.com']);

// Buscar um
$user = $db->getSingle('users', 1);
echo $user->name; // Sintaxe de objeto

// Atualizar
$db->update('users', ['name' => 'João Santos'], 1);

// Deletar
$db->delete('users', 1);

// Buscar todos
$users = $db->getAll('users');

Paginação

// Criar paginador (10 itens por página)
$paginator = $app->createPaginator('users', 10);
$data = $paginator->getResult();

// Informações da paginação
echo "Total: {$data->total} | Página {$data->currentPage} de {$data->totalPages}";

// Exibir dados
foreach ($data->data as $user) {
    echo "{$user->name} - {$user->email}<br>";
}

// Links de navegação
echo $paginator->render();

Exemplos Práticos

A biblioteca inclui exemplos completos na pasta examples/:

Como executar os exemplos

# Iniciar servidor local
php -S localhost:8000

# Acessar exemplos
http://localhost:8000/examples/crud_basico.php

Busca Personalizada

$db = $app->getDatabase();

// Busca com prepared statements
$sql = "SELECT * FROM users WHERE name LIKE :search";
$stmt = $db->getConnection()->prepare($sql);
$stmt->execute(['search' => '%João%']);
$users = $stmt->fetchAll();

Segurança

• Prepared Statements - Proteção contra SQL Injection
• Validação de entrada - Nomes de tabelas validados
• Tipagem forte - Previne erros em runtime

Requisitos

• PHP >= 7.4
• PDO extension
• MySQL/MariaDB

Testes

A biblioteca inclui uma suite completa de testes:

# Executar todos os testes
composer test

# Apenas testes unitários
vendor/bin/phpunit tests/Unit/

# Apenas testes de integração
vendor/bin/phpunit tests/Integration/

# Com cobertura de código
composer test-coverage

O que é testado:

• ✅ Operações CRUD - Insert, update, delete, select
• ✅ Sintaxe de objeto - Sempre $data->propriedade, nunca arrays
• ✅ Segurança - Prepared statements e validação
• ✅ Paginação - Cálculos e renderização
• ✅ Padrão Singleton - App::boot() funcional
• ✅ Workflow completo - Testes de integração

Veja tests/README.md para documentação completa dos testes.

Licença

MIT License. Veja LICENSE para detalhes.

Contribuição

1. Fork o projeto
2. Crie uma branch (git checkout -b feature/nova-feature)
3. Commit suas mudanças (git commit -m 'Adiciona nova feature')
4. Push para a branch (git push origin feature/nova-feature)
5. Abra um Pull Request

⭐ Gostou do projeto? Dê uma estrela no GitHub!