Página Inicial>Código fonte PHP>Outras categorias
Baixar

Quebee: um construtor de consultas PHP SQL 

            ███████╗ ██╗   ██╗███████╗                               ...vvvv)))))).
            ██╔═══██╗██║   ██║██╔════╝    /~~               ,,,c(((((((((((((((((/
            ██║██╗██║██║   ██║█████╗     /~~c .         .vv)))))))))))))))))))``
            ███████╔╝██║   ██║██╔══╝         G_G__   ,,(((KKKK//////////////'
             ╚═██╔═╝ ╚██████╔╝███████╗     ,Z~__ '@,gW@@AKXX~MW,gmmmz==m_.
               ╚═╝    ╚═════╝ ╚══════╝    iP,dW@!,A@@@@@@@@@@@@@@@A` ,W@@Ac
            ██████╗ ███████╗███████╗       ]b_.__zf !P~@@@@@*P~b.~+=m@@@*~ g@Ws.
            ██╔══██╗██╔════╝██╔════╝          ~`    ,2W2m. '[ ['~~c'M7 _gW@@A`'s
            ██████╦╝█████╗  █████╗              v=XX)====Y-  [ [    c/*@@@*~ g@@i
            ██╔══██╗██╔══╝  ██╔══╝             /v~           !.!.     'c7+sg@@@@@s.
            ██████╦╝███████╗███████╗          //              'c'c       'c7*X7~~~~
            ╚═════╝ ╚══════╝╚══════╝         ]/                 ~=Xm_       '~=(Gm_.

Introdução

O pacote qᴜᴇᴇbᴇᴇ (qb) ou consultor de consultas é um pacote leve para criar consultas MySQL. É um pacote PHP que simplifica a construção de consultas SQL. Ele fornece uma abordagem orientada a objetos para criar consultas SQL, facilitando a criação, modificação e execução de instruções SQL em seus aplicativos PHP.

Instalação

1. Compositor

O Quebee pode ser instalado via Composer, um gerenciador de dependência do PHP. Se você ainda não instalou o Composer, visite o site da Composer para obter instruções.

Execute o seguinte comando para instalar o Quebee: 

composer require hindbiswas/quebee

2. Auto -carregamento

Verifique se o AutoloDer do compositor está incluído nos arquivos PHP do seu projeto. Use seu caminho no lugar do path/to/ : 

 require_once __DIR__ . DIRECTORY_SEPARATOR . ' path/to ' . ' /vendor/autoload.php ' ;

Características

Quebee fornece recursos a seguir para trabalhar com o MySQL:

  1. Consultas: Classe Query para consultas SELECT , INSERT , UPDATE e DELETE .
  2. Tabela: Table Classe para CREATE TABLE Juntamente com Classe Col para Colunas.
  3. Colunas: a classe Col possui vários tipos de dados como INT , VARCHAR , DATETIME e muito mais para criar colunas conforme seus requisitos.
  4. Declarações: Classe Stmt para UNION , UNION ALL , CUBE , SET e GROUPING SETS declarações.

Ele também inclui restrições de chave estrangeira, chave primária, chave e indexação, bem como agrupamento. Consulte o /tests/ Diretório para obter todas as maneiras possíveis de usar o QueBee ;

Uso

Abaixo estão exemplos de como usar cada construtor de consultas.

1. Selecione Consulta

Para criar uma consulta SELECT , use o método Query::select() : 

 use Hindbiswas  QueBee  Query ;

$ aliased_cols = [ ' alias1 ' => ' column1 ' , ' alias2 ' => ' column2 ' , ' column3 ' => ' column3 ' ];
$ query = Query:: select ( $ aliased_cols )-> from ( ' table ' )-> build ();

// Resulting SQL query
// SELECT column1 AS alias1, column2 AS alias2, column3 AS column3 FROM table;

Ou, 

 use Hindbiswas  QueBee  Query ;

$ query = Query:: select ([ ' column1 ' , ' column2 ' ])
    -> from ( ' table ' )
    -> where ( ' column1 ' , ' value ' )
    -> orderBy ( ' column2 ' , ' desc ' )
    -> limit ( 10 )
    -> build ();

// Resulting SQL query
// SELECT column1, column2 FROM table WHERE column1 = 'value' ORDER BY column2 DESC LIMIT 0, 10;

Aliases de condição para declarações condicionais

SQL Literal Simbólico
> gt >
>= gte >=
< lt <
<= lte <=
= eq == ou =
!= ne != ou <>
<=> ns <=>
LIKE like ??

Você pode usar literal ou simbólico.

2. Insira consultas

Para criar uma consulta INSERT , use o método Query::insert() (para inserir várias linhas de uma só vez, use o método Query::insertMultiple() ): 

 use Hindbiswas  QueBee  Query ;

$ data = [ ' column1 ' => ' value1 ' , ' column2 ' => ' value2 ' ];

$ query = Query:: insert ( $ data )
    -> into ( ' table ' )
    -> build ();

// Resulting SQL query
// INSERT INTO table (column1, column2) VALUES ('value1', 'value2');

3. Consultas de atualização

Para criar uma consulta UPDATE , use o método Query::update() : 

 use Hindbiswas  QueBee  Query ;

$ data = [ ' column1 ' => ' new_value1 ' , ' column2 ' => ' new_value2 ' ];

$ query = Query:: update ( ' table ' )
    -> set ( $ data )
    -> where ( ' column1 ' , ' value1 ' )
    -> build ();

// Resulting SQL query
// UPDATE table SET column1 = 'new_value1', column2 = 'new_value2' WHERE column1 = 'value1';

4. Exclua consultas

Para criar uma consulta DELETE , use o método Query::delete() : 

 $ query = Query:: delete ( ' table ' )-> where ( ' column1 ' , 1 , ' gt ' )-> build () // Here `gt` is alias for `>`

// Resulting SQL query
// DELETE FROM table WHERE column1 > '1';

5. Crie consultas de tabela

Para criar uma consulta CREATE TABLE , use o método Table::create() :

Sem chaves estrangeiras 

 use Hindbiswas  QueBee  Col ;
use Hindbiswas  QueBee  Table ;
use Hindbiswas  QueBee  Table  Values  DefaultVal ;

$ usersTable = Table:: create ( ' users ' )-> columns ([
    ' id ' => Col:: integer ( 11 )-> unsigned ()-> pk ()-> ai (),
    ' username ' => Col:: varchar ()-> unique (),
    ' email ' => Col:: varchar ()-> unique (),
    ' password ' => Col:: varchar (),
    ' is_superadmin ' => Col:: integer ( 2 )-> default ( ' 0 ' ),
    ' create_time ' => Col:: dateTime ()-> default (DefaultVal:: CURRENT_TIME ),
    ' update_time ' => Col:: dateTime ()-> setOnUpdate ()-> default (DefaultVal:: CURRENT_TIME ),
]);

$ query = $ usersTable -> build ();

// Resulting SQL query
// CREATE TABLE IF NOT EXISTS users (`id` INT(11) UNSIGNED NULL AUTO_INCREMENT, `username` VARCHAR(255) NOT NULL, `email` VARCHAR(255) NOT NULL, `password` VARCHAR(255) NOT NULL, `is_superadmin` INT(2) NOT NULL DEFAULT '0', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, `update_time` DATETIME on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, CONSTRAINT users_PK PRIMARY KEY (id), CONSTRAINT username_UC UNIQUE (`username`), CONSTRAINT email_UC UNIQUE (`email`)) ENGINE = InnoDB;

Com chaves estrangeiras 

 use Hindbiswas  QueBee  Col ;
use Hindbiswas  QueBee  Table ;
use Hindbiswas  QueBee  Table  Values  DefaultVal ;
use Hindbiswas  QueBee  Table  Values  FK ;

// $usersTable = create a table to constrain with

$ table = Table:: create ( ' tokens ' )-> columns ([
    ' id ' => Col:: integer ()-> unsigned ()-> pk ()-> ai (),
    ' selector ' => Col:: varchar (),
    ' hashed_validator ' => Col:: varchar (),
    ' user_id ' => Col:: integer ( 11 )-> unsigned (),
    ' expiry ' => Col:: dateTime (),
])-> foreign ( ' user_id ' )-> onDelete ( FK :: CASCADE )-> reference ( $ usersTable , ' id ' );

// Resulting SQL query
// CREATE TABLE IF NOT EXISTS tokens (`id` INT UNSIGNED NULL AUTO_INCREMENT, `selector` VARCHAR(255) NOT NULL, `hashed_validator` VARCHAR(255) NOT NULL, `user_id` INT(11) UNSIGNED NOT NULL, `expiry` DATETIME NOT NULL, CONSTRAINT tokens_PK PRIMARY KEY (id), FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE) ENGINE = InnoDB;

Tipos de dados disponíveis a partir da v1.2.0

  • Corda
    • Texto => Col::text()
    • Varchar => Col::varchar(225)
  • Numérico
    • Bit => Col::bit()
    • Int => Col::integer()
    • Bigint => Col::bigInt()
    • MediumInt => Col::mediumInt()
    • SmallInt => Col::smallInt()
    • Tinyint => Col::tinyInt()
    • Decimal => Col::decimal(11, 6)
    • Float => Col::float(6, 2)
    • Duplo => Col::double(11, 6)
    • Real => Col::real(11, 6)
  • Tempo
    • Data => Col::date()
    • DateTime => Col::dateTime()

Práticas recomendadas

Aqui estão algumas práticas recomendadas ao usar Quebee :

  1. Habilizar entradas do usuário: sempre higienize as entradas do usuário antes de usá -las em consultas.

  2. Manuseio de erros: lide com exceções adequadamente, especialmente ao criar consultas. O Quebee pode lançar exceções para entrada inválida de entrada ou método.

  3. Abstração do banco de dados: Considere o uso de uma camada de abstração de banco de dados ao lado de Quebee para interações mais extensas de banco de dados.

  4. Organização de código: organize seu código logicamente, separando a construção de consultas da execução e manuseio de resultados.

Conclusão

O Quebee simplifica a construção de consultas SQL no PHP, facilitando a criação de interações de banco de dados limpas, seguras e eficientes. Com sua API fluente, ela fornece uma maneira amigável de criar consultas SQL para vários sistemas de banco de dados.

Para opções de uso e personalização mais detalhadas, consulte o repositório de Quebee Github.

É isso! Você está pronto para começar a usar o Quebee para criar consultas SQL em seus aplicativos PHP.

Expandir
Informações adicionais
Aplicativos Relacionados
Recomendado para você
Informações Relacionadas Todos