README

Note

This repository has been migrated to Codeberg, please see: https://codeberg.org/bluice/miphantdb

MiPhantDB é uma biblioteca leve, fluente e orientada a código escrita em PHP para abstração de banco de dados MySQL/MariaDB, focada em simplicidade, controle explícito das queries e baixo overhead.

Oferece uma API encadeável (fluent interface) para construção de SQL legível, previsível e flexível, mantendo o desenvolvedor no controle total da query final.

Ideal para projetos que precisam de produtividade, performance, CLIs, APIs, sistemas legados e ambientes com pouco recurso.

✨ Características

• Abstração leve sobre MySQLi
• API fluente (encadeável)
• Suporte a SELECT, INSERT, UPDATE, DELETE
• Suporte a prepared statements
• Construção dinâmica de WHERE, ORDER BY e LIMIT
• Criação e alteração de tabelas via código
• Suporte a INNER JOIN
• Modo sandbox para debug
• Zero dependências externas
• Compatível com PHP 8.4 ou superior

📦 Instalação

Via Composer (recomendado)

composer require bluiceoficial/miphantdb

Manual

Copie os arquivos da pasta MiPhantDB para o seu projeto e utilize o include_once para adicionar as classes como database, select, insert, update, delete, table.

🔌 Conexão com o banco

use MiPhantDB\database;

$db = new database([
    'server'   => 'localhost',
    'username' => 'root',
    'password' => '',
    'database' => 'meubanco'
], true); // true ativa o modo sandbox (logs em tela)

📖 SELECT

use MiPhantDB\select;

$select = new select([
    'server'   => 'localhost',
    'username' => 'root',
    'password' => '',
    'database' => 'meubanco'
]);

$select->table('users')
    ->column('id')
    ->column('name')
    ->where('status', 'ativo')
    ->orderby('name')
    ->limit(0, 10)
    ->select();

while ($row = $select->fetch()) {
    echo $row['name'];
}

$select->close();

🔐 Prepared Statements

$select->table('users')
    ->where('id', '?')->prepared(1, 'i')
    ->select();

$select->getResult();

$row = $select->fetch();

➕ INSERT

use MiPhantDB\insert;

$insert = new insert($dbConfig);

$insert->table('users')
    ->add('name', '?')
    ->add('email', '?')
    ->prepared('Murilo', 's')
    ->prepared('murilo@email.com', 's')
    ->insert();

$id = $insert->idinsert();

✏️ UPDATE

use MiPhantDB\update;

$update = new update($dbConfig);

$update
    ->table('users')
    ->add('email', '?')
    ->where('id', '?')
    ->prepared('novo@email.com', 's')
    ->prepared(1, 'i')
    ->update();

❌ DELETE

use MiPhantDB\delete;

$delete = new delete($dbConfig);

$delete->table('users')
    ->where('id', 1)
    ->delete();

🧱 Criação de tabelas

use MiPhantDB\table;

$table = new table($dbConfig);

$table->table('users')
    ->int()->autoIncrement()->primaryKey()->add('id')
    ->varcharSize(100)->add('name')
    ->varcharSize(150)->add('email')
    ->engine('InnoDB')
    ->create();

🔧 Alterar tabela

$table
    ->table('users')
    ->varcharSize(255)->add('bio')
    ->alter(table::ALTER_ADD);

🔍 Verificar se coluna existe

if (!$table->columnExists('email')) {
    // criar coluna
}

🔒 Encerrando a conexão (close)

Após executar as operações no banco de dados, é recomendável encerrar explicitamente a conexão para liberar recursos de memória e resultados pendentes.

$select->close();

O que o close() faz?

• Libera automaticamente o result set (mysqli_free_result) quando aplicável
• Finaliza corretamente prepared statements
• Encerra a conexão ativa com o banco (mysqli_close)
• Evita vazamento de memória em scripts longos ou CLIs

Quando usar?

• Após finalizar uma consulta CREATE, ALTER, SELECT, INSERT, UPDATE ou DELETE
• Em scripts CLI, workers e processos de longa duração
• Em loops ou execuções repetidas de queries

Exemplo completo

$select->table('users')
    ->where('status', 'ativo')
    ->select();

while ($row = $select->fetch()) {
    echo $row['name'];
}

$select->close();

💡 Dica: Embora o PHP feche conexões automaticamente ao final do script, o uso explícito de close() é uma boa prática para garantir desempenho e previsibilidade.

🧠 Outras Informações

• Sem ORM pesado
• Sem reflexão ou proxies mágicos
• SQL continua sendo SQL
• Código previsível e fácil de depurar
• Ideal para quem gosta de controle

👤 Autor

Murilo Gomes Julio

🔗 https://www.bluice.com.br

📺 https://youtube.com/@bluiceoficial

🤝 Support

• GitHub Sponsors: https://github.com/sponsors/bluiceoficial
• Apoie o projeto: https://www.bluice.com.br/apoie/

📜 License

The MiPhantDB is provided under:

SPDX-License-Identifier: LGPL-2.1-only

Beign under the terms of the GNU Lesser General Public License version 2.1 only.

All contributions to the MiPhantDB are subject to this license.