gallahaaz/sql-query-library

A PHP class to manipulate sql data

dev-master 2017-05-24 18:14 UTC

MIT

• Kevin Gallahaaz

• sql
• query

README

Pequena lib de comandos sql para simplificar conexões com o mysql.
Opera apenas com um banco de dados e schema por vez, logo é indicada para websites simples que operem apenas uma base de dados por vez.

• Download
• Utilização
• Funções
• query( $command )
• getLastId()
• fetch( $result, $method = MYSQLI_BOTH, $index = null )
• fetchDecode( $result, $method = MYSQLI_BOTH, $index = null )
• fetchSingle( $result, $method = MYSQLI_BOTH )
• select( $fields, $table, $searchFields=null, $options=null )
• insert( $table, $columns, $values)
• update( $table, $set, $where )
• delete( $table, $where )
• Requisitos

Download

Composer - Apenas é necessário incluir no require : "gallahaaz/sql-query-library": "dev-master"

Utilização

A conexão é simples , apenas sendo necessário configurar as seguintes constantes

DBHOST - Host do servidor, que pode ser local ou remoto

DBLOGIN - Login de acesso ao servidor mysql

DBPASSWORD - Senha de acesso ao servidor mysql

DBSCHEMA - Schema alvo do servidor

Após a configuração, apenas é necessário utilizar use Gallahaaz\SqlQueryLibrary\Query e instanciar o objeto em uma variável.

Funções

query( $command )

- Realiza qualquer comando $command(string) sql informado

getLastId()

- Retorna o id do ultimo insert executado (return int)

fetch( $result, $method = MYSQLI_BOTH, $index = null )

- Realiza o fetch de qualquer resultado de query() passado através de $result, atribuindo os valores a um array. $method(string) pode ser alterada na chamada da função para que o retorno seja apenas numérico ou associativo.
A função retorna os resultados em uma matriz tridimensional indexada numericamente, seguida pelos campos selecionados através do $method, caso $index(string) não seja definida.
Se $index(string) for definida, o index primário do campo será relacionado aos valores indexados na no retorno da mysqli->fetch_array.

fetchDecode( $result, $method = MYSQLI_BOTH, $index = null )

- Opera identicamente a fetch, apenas aplicando url_decode no retorno dos valores vindos do banco de dados.

fetchSingle( $result, $method = MYSQLI_BOTH )

- Realiza o fetch e retorna o último valor do resultado da query. Asim como o nome sugere, é indicado para buscas com resultado único.

select( $fields, $table, $searchFields=null, $options=null )

- Realiza o comando select. $fields(array) define quais campos serão buscados através de um array contendo os nomes dos campos da tabela a serem pesquisados. Exemplos :

• $fields = ['nome', 'email'];
• $fields = ['DISTINCT nome'];
• $fields = ['DISTINCT nome','email'];
• $fields = ['COUNT(DISTINCT Country)'];

$table(string) define qual a tabela que deverá ser pesquisada. $searchFields(matriz) recebe os valores que serão usados de filtro no select. Exemplos :

• $searchFields = [ 'nome' => 'joão', 'email' => '[e-mail]' ];
• $searchFields = [ 'id' = 1 ];

$options(string) recebe uma string que pode conter qualquer comando sql posterior ao SELECT * FROM table WHERE data=data ($options)

insert( $table, $columns, $values)

- Realiza uma inserção na tabela $table(string) nas $columns(array) dos $values(array). Ex :
$table = 'user';
$columns = ['nome','email','username'];
$values = ['Kevin G', '[e-mail]', 'gallahaaz' ];
$sql-query-library-object->insert($table, $columns, $values);

update( $table, $set, $where )

- Realiza uma operação de atualização no banco de dados. Atualiza $table com dados de $set em $where. Ex : $table = 'user';
$set = [
'nome' => 'Arthur',
'email' => '[e-mail]' ];
$values = ['Kevin G', '[e-mail]', 'gallahaaz' ];
$sql-query-library-object->update($table, $columns, $values);

delete( $table, $where )

- Realiza uma operação de exclusão no banco de dados. Exclui um valor em $table baseado em $where

Requisitos

• Php 5.6.x ou superior
• composer
• extensão mysqli ativa