Download the PHP package 89bsilva/my-database without Composer

MyDatabase

MyDatabase é uma ferramenta desenvolvida em PHP para realizar operações muito simples em base de dados MySQL

Instalação

Primeiro Passo

Importar o autoload do composer

Criando o obejto MyDatabase

Ao instânciar a classe você deve passar dois parâmetros:

Exemplos:

Criando conexão no servidor: "localhost", porta: "3308", banco: "loja", usuário: "admin", senha: "123", charset: "utf8mb4", collation: "unicode_ci" e engine: "MyISAM"

Criando conexão no servidor: "localhost", porta: "3306", banco: "loja", usuário: "admin", senha: "", charset: "utf8", collation: "general_ci" e engine: "InnoDB"

MyDatabase

Métodos da classe MyDatabase

table($tabela)

@param string $tabela Nome da tabela que deseja realizar alguma(s) alteração(ões) @return Objeto da classe Table

insert($dados)

@param array $dados Dados que será(ão) inserido(s) @return Objeto da classe Insert

select($coluna [, $coluna, $...])

@param string $coluna Declaração com a(s) coluna(s) que será(ão) selecionada(s) @return Objeto da classe Select

update($tabela)

@param string $tabela Nome da tabela que contém o(s) registro(s) será(ão) atualizado(s) @return Objeto da classe Update

delete($tabela)

@param string $tabela Nome da tabela que contém o(s) registro(s) será(ão) deletado(s) @return Objeto da classe Delete

Table

Métodos da classe Table

addColumn($coluna)

@param string $coluna Nome da coluna que será adicionada @return Objeto atual

dropColumn($coluna)

@param string $coluna Nome da coluna que será removida @return bool true se deletou a coluna false caso contrário

changeColumn($coluna, $novoNome)

@param string $coluna Nome da coluna que será modificada @param string $novoNome (Opcional) Novo nome da coluna que será modificada @return Objeto atual

showColumn($coluna)

@param string $coluna Nome da coluna que será obtida as informações @return array

showColumns()

@return array

int($tamanho)

@param int $tamanho Tamanho máximo para coluna @return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define o tipo: INT e tamanho: $tamanho para coluna que será adicionada ou alterada

bool()

@return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define o tipo: TINYINT e tamanho: 1 para coluna que será adicionada ou alterada

float($precisao)

@param int|string $precisao Precisão para o armazenamento do tipo Float @return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define o tipo: FLOAT e com precisão: $precisao para coluna que será adicionada ou alterada

double($precisao)

@param int|string $precisao Precisão para o armazenamento do tipo Double @return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define o tipo: DOUBLE e com precisão: $precisao para coluna que será adicionada ou alterada

text()

@return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define o tipo: TEXT para coluna que será adicionada ou alterada

mediumtext()

@return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define o tipo: MEDIUMTEXT para coluna que será adicionada ou alterada

longtext()

@return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define o tipo: LONGTEXT para coluna que será adicionada ou alterada

varchar($tamanho)

@param int $tamanho Tamanho máximo para coluna @return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define o tipo: VARCHAR e tamanho: $tamanho para coluna que será adicionada ou alterada

timestamp()

@param int $tamanho Tamanho máximo para coluna @return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define o tipo: TIMESTAMP para coluna que será adicionada ou alterada

addTimes($ptBR)

@param bool $ptBR (Opcional) Caso seja true os nomes das colunas serão (criado_em, atualizado_em) @return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Adiciona na tabela duas colunas do tipo timestamp (created_at, updated_at). As colunas terão valor padrão CURRENT_TIMESTAMP A coluna updated_at será atualizada automáticamente com CURRENT_TIMESTAMP quando a tabela for atualizada

default($valorPadrao)

@param int|string $valorPadrao Valor padrão da coluna que será criada/alterada @return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método

after($coluna)

@param int|string $coluna Nome da coluna que antecede a nova coluna a ser adicionada ou movida @return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método

autoIncrement()

@return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define que coluna a ser adicionada/alterada será auto encrementada.

notNull()

@return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define que o valor armazenado na coluna a ser adicionada/alterada não pode ser nulo.

primary()

@return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define a coluna a ser adicionada/alterada será chave primária.

unique()

@return Objeto atual Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método Define que o valor armazenado na coluna a ser adicionada/alterada será unico na tabela.

create($mostrarDeclaracao)

@param bool $mostrarDeclaracao (Opcional, Padrão: false) Sinaliza se a declaração que será executada irá retornar na resposta @return array Obs.: addColumn() DEVE ser chamado antes desse método

alter($mostrarDeclaracao)

@param bool $mostrarDeclaracao (Opcional, Padrão: false) Sinaliza se a declaração que será executada irá retornar na resposta @return array Obs.: addColumn() ou changeColumn() DEVE ser chamado antes desse método

drop()

@return bool Deleta a tabela

clean()

@return bool Remove todos os registros da tabela

Exemplos:

• Criar tabela: "cliente" com:

  • coluna: id, tipo: int, tamanho: 11, não pode ter valor nulo, auto incrementado e chave primária
  • coluna: nome, tipo: varchar, tamanho: 25 e não pode ter valor nulo
  • coluna: cidade, tipo: varchar, tamanho: 25 e não pode ter valor nulo
  • coluna: CPF, tipo: int, tamanho: 11, não pode ter valor nulo e valor único
  • coluna: preferencial, tipo: tinyint, tamanho: 1, pode ter valor nulo e valor padrão 0
• Criar tabela: "produto" com:
  • coluna: id, tipo: int, tamanho: 11, não pode ter valor nulo, auto incrementado e chave primária
  • coluna: codigo, tipo: int, tamanho: 11, não pode ter valor nulo e valor único
  • coluna: descricao, tipo: varchar, tamanho: 100 e não pode ter valor nulo
  • coluna: preco, tipo: float, precisão: 7,2, não pode ter valor nulo
  • coluna: quantidade, tipo: int, tamanho: 11 e não pode ter valor nulo
  • coluna: criado_em, tipo: timestamp e como valor padrão o timestamp atual
  • coluna: atualizado_em, tipo: timestamp e como valor padrão o timestamp atual
• Criar tabela: "usuario" com:
  • coluna: id, tipo: int, tamanho: 11, não pode ter valor nulo, auto incrementado e chave primária
  • coluna: nome, tipo: varchar, tamanho: 25 e não pode ter valor nulo
  • coluna: email, tipo: varchar, tamanho: 50, não pode ter valor nulo e com valor único
  • coluna: ativo, tipo: tinyint, tamanho: 1, pode ter valor nulo e valor padrão 1

Realizando alterações na tabela usuario: Alterar o nome da coluna emil para email, mudar o tamanho dela de varchar(50) para varchar(100) e adicionar após a coluna email a coluna: senha, tipo: varchar, tamanho: 10, não pode ter valor nulo

Deletar a tabela: "usuario"

Insert

into($tabela)

@param string $tabela Nome da tabela que deseja onde será realizado a inserção de dados @return Objeto atual

execute()

@return int O número de registros inseridos

Exemplos:

Cadastro de UM cliente na tabela "cliente"

Cadastro de TRÊS produtos na tabela "produto"

Select

from($tabela)

@param string $tabela Tabela onde a consulta será realizada @return Objeto atual

from($tabela)

@param string $tabela Tabela onde a consulta será realizada @return Objeto atual

where($coluna)

@param string $coluna Coluna utilizada para comparar @return Objeto atual Veja como construir a cláusula WHERE

limit($limite, $deslocamento)

@param int $limite Limite para consulta @param int $deslocamento Início da consulta @return Objeto atual Obs.: Se esse método não for chamada antes de executar a consulta o limite padrão será 100 e o início da consulta padrão será 0

order($coluna, $ordenar)

@param string $coluna Nome(s) da(s) coluna(s) pela qual a consulta será ordenada @param string $ordenar Direção da ordenação (Padrão: ASC) @return Objeto atual

execute()

@return Array Executa o select, retorna uma lista com os registros do SELECT ou array vazio

Exemplos:

Buscar na tabela "produto" TODOS os dados de produtos com QUANTIDADE MAIOR OU IGUAL 1 e com PREÇO MENOR que R$60 e ordernar por preço

Buscar na tabela "cliente" o NOME dos clientes da cidade de São Paulo. No máximo 100 registros (limite padrão).

UPDATE

set($dadosAtualizados)

@param array $dadosAtualizados Array associativo com o(s) dado(s) que será(ão) atualizado(s) @return Objeto atual

where($coluna)

@param string $coluna Coluna utilizada para comparar @return Objeto atual Veja como construir a cláusula WHERE

limit($limite, $deslocamento)

@param int $limite Limite para atualização @param int $deslocamento Início da atualização @return Objeto atual Obs.: Se esse método não for chamada antes de executar a atualização o limite padrão será 1 e o início da consulta padrão será 0

execute()

@return int Retorna o número de linhas que a atualização afetou

Exemplo:

Atualizar na tabela "produto" a quantidade do produto com código igual a 123456 para 4

DELETE

where($coluna)

@param string $coluna Coluna utilizada para comparar @return Objeto atual Veja como construir a cláusula WHERE

limit($limite, $deslocamento)

@param int $limite Limite para exclusão @param int $deslocamento Início da exclusão @return Objeto atual Obs.: Se esse método não for chamada antes de executar a exclusão o limite padrão será 1 e o início da consulta padrão será 0

execute()

@return int Retorna o número de linhas que o delete afetou

Exemplo:

Deletar na tabela "produto" o produto com código igual a 234567

WHERE

where($coluna)

@param string $coluna Coluna utilizada para comparar @return Objeto atual

between($valor1, $valor2)

@param string | int $valor1 Primeiro valor do intervalo @param string | int $valor2 Segundo valor do intervalo @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

notBetween($valor1, $valor2)

@param string | int $valor1 Primeiro valor do intervalo @param string | int $valor2 Segundo valor do intervalo @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

equals($valor)

@param string | int $valor Valor que será comparado utilizando o operador = @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

notEquals($valor)

@param string | int $valor Valor que será comparado utilizando o operador != @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

different($valor)

@param string | int $valor Valor que será comparado utilizando o operador <> @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

less($valor)

@param string | int $valor Valor que será comparado utilizando o operador < @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

lessEqual($valor)

@param string | int $valor Valor que será comparado utilizando o operador <= @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

bigger($valor)

@param string | int $valor Valor que será comparado utilizando o operador > @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

in($lista)

@param array $lista Valores que serão comparados @return Objeto atual É uma abreviação para várias condições OR onde o obejtivo são valores que estão na lista
Obs.: where() DEVE ser chamado antes desse método

notIn($lista)

@param array $lista Valores que serão comparados @return Objeto atual É uma abreviação para várias condições OR onde o obejtivo são valores que NÃO estão na lista
Obs.: where() DEVE ser chamado antes desse método

isNull()

@return Objeto atual Obejtiva registro(s) com valor NULL
Obs.: where() DEVE ser chamado antes desse método

isNotNull()

@return Objeto atual Obejtiva registro(s) com valor diferente de NULL
Obs.: where() DEVE ser chamado antes desse método

like($valor)

@param string $valor Valor que será comparado utilizando o coringa "%" antes e depois de valor: "%$valor%" @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

likeStart($valor)

@param string $valor Valor que será comparado utilizando o coringa "%" depois de valor: "$valor%" @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

likeEnd($valor)

@param string $valor Valor que será comparado utilizando o coringa "%" antes de valor: "%$valor" @return Objeto atual Obs.: where() DEVE ser chamado antes desse método

likeStartEnd($valor1, $valor2)

@param string $valor1 Primeiro valor da comparação @param string $valor2 Segundo valor da comparação @return Objeto atual A comparação será realizada utilizando o coringa "%" entre valor1 e valor2: "$valor1%$valor2" Obs.: where() DEVE ser chamado antes desse método

and($coluna)

@param string $coluna Coluna da nova condição @return Objeto atual Inicia uma nova condição de comparação com o operador AND Obs.: where() e algum método de comparação "between(), notBetween(), equals(), ..." DEVEM ser chamados antes desse método

or($coluna)

@param string $coluna Coluna da nova condição @return Objeto atual Inicia uma nova condição de comparação com o operador OR Obs.: where() e algum método de comparação "between(), notBetween(), equals(), ..." DEVEM ser chamados antes desse método

Autor

Bruno Silva Santana - https://github.com/ibrunosilvas

Licença

MyDatabase está licenciado sob a licença MIT - consulte o arquivo LICENSE para mais detalhes.