Download the PHP package 07matheus/db_manager without Composer

DB MANAGER

• Gerenciador de conexões com banco de dados;
• Modelagem de tabelas;

REQUISITOS

• php: 7.2^
• composer: 2.4.4^

UTILIZAÇÃO

INSTALAÇÃO

Para instalar essa dependência, utilize o comando abaixo:

CONFIGURAÇÃO

Realize a configuração do arquivo .env, no mesmo nível do arquivo composer.json;

• PARÂMETROS REQUERIDOS:
  • DB_HOST: Host onde banco de dados do projeto está armazenado;
  • DB_DATABASE: Nome do banco de dados;
  • DB_USERNAME: Nome do usuário do banco;
  • DB_PASSWORD: Senha do banco de dados
  • DB_PORT: Porta de conexão com o banco;
  • DB_CONNECTION: Driver de conexão;
  • DB_CHARSET: Tipo da colação dos dados adicionados ao banco;
  • DB_OUTPUT_MESSAGE: Define como as mensagens de erro de execução de consultas serão exibidas (html, json, default);
  • DB_PROTECTED_MODE: Define se as mensagens de erro serão exibidas na íntegra.

Inicializando a classe:

GERENCIADOR DE CONSULTAS

Realizando uma consulta:

function select():

• PARÂMETROS:
  • campo: Define os campos que serão retornados na consulta;
  • DEFAULT: Todos os campos da tabela;
  • OBRIGRATÓRIO: não;

Inserindo ou atualizando um registro:

function insert():

function replace():

function update():

• PARÂMETROS:

  • dados: Define quais os dados serão inseridos;
  • REQUISITOS: Uma array com os dados e os campos da tabela, ou um objeto da tabela implementado por \MatheusV\DBManager\Table\ModeloTabela;

  • OBRIGRATÓRIO: sim;

  • camposSemAspas: Define quais os campos que não terão aspas inclusas quando a query for gerada;
  • REQUISITOS: Uma array informando os campos sem aspas;
  • OBRIGRATÓRIO: não;

  • DEFAULT: array();

  • ignore: Adiciona o ignore a query;
  • REQUISITOS: Uma array informando os campos sem aspas;
  • OBRIGRATÓRIO: não;
  • DEFAULT: false;

Removendo um registro:

function delete():

OPÇÕES AVANÇADAS

function send():

• PARÂMETROS:
  • prepare: Força a utilização do método prepare() do PDO na consulta;
  • DEFAULT: false;
  • OBRIGRATÓRIO: não;

function where():

• PARÂMETROS:
  • condicoes: Define as condições para a consulta;
  • REQUISITOS: Uma array com as condições da consulta;
  • DEFAULT: array();
  • OBRIGRATÓRIO: não;

function order():

• PARÂMETROS:
  • orders: Define as ordenações dos dados consultados;
  • REQUISITOS: Uma array com as ordenações dos dados;
  • DEFAULT: array();
  • OBRIGRATÓRIO: não;

function group():

• PARÂMETROS:
  • groups: Define o agrupamento de dados;
  • REQUISITOS: Uma array com os agrupamentos;
  • DEFAULT: array();
  • OBRIGRATÓRIO: não;

function innerJoin():

function leftJoin():

• PARÂMETROS:
  • joins: Define as tabelas que serão adicionadas a uma consulta;
  • REQUISITOS: Uma array, definindo a tabela e as condições de adição;
  • DEFAULT: array();
  • OBRIGRATÓRIO: não;

function setLimit():

• PARÂMETROS:
  • limit: Define o limite de registros que vão ser buscados;
  • REQUISITOS: Número inteiro do limite de registros;
  • OBRIGRATÓRIO: sim;

function setOffset():

• PARÂMETROS:
  • offset: Define o deslocamento dos dados da consulta;
  • REQUISITOS: Número inteiro, que define o deslocamento de dados;
  • OBRIGRATÓRIO: sim;

MODELAGEM DE TABELAS

Nesse pacote, é possível definir classes modelos de tabelas, tanto para utilizar no código, quanto para realizar consultas utilizando o gerenciador de conexões.

Para definir um modelo de tabela, é necessário utilizar as seguintes classes:

• use \MatheusV\DBManager\Table\ModeloTabela;
• use \MatheusV\DBManager\Table\GetSet;

EX:

DEFININDO VALORES PARA A CLASSE MODELO

É possível adicionar valores a classe de duas maneiras:

• Adicionando o valor a propriedade da classe;
• Passando uma array com as propriedades e valores da classe;

EX:

RETORNANDO OS DADOS DA CLASSE

Também é possível retornar valores atribuídos a classe em forma de array, utilizando o método getAttributes(). Ele possui dois parâmetros:

• toClass: Retorna os índices da array, formatados como os parâmetros da classe;

  • DEFAULT: true.
• others: Retorna os campos que não existirem nos parâmentros da classe;
  • DEFAULT: false.

EX: