PHPackages jheferson-br/tquery - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. jheferson-br/tquery ActiveLibrary jheferson-br/tquery =================== Lib em PHP para execução de arquivos SQL. Uso restrito para projetos Adianti 1.0.7(5y ago)12194mitPHP Since Aug 6Pushed 5y ago2 watchersCompare [ Source](https://github.com/JhefersonBR/TQuery)[ Packagist](https://packagist.org/packages/jheferson-br/tquery)[ RSS](/packages/jheferson-br-tquery/feed)WikiDiscussions master Synced today READMEChangelogDependenciesVersions (8)Used By (0) TQuery ====== [](#tquery) Sobre o Componente ------------------ [](#sobre-o-componente) A classe TQuery foi desenvolvida para trazer para o Adianti framework uma abordagem diferente na montagem e execução das querys. Com ela é possível executar arquivos **'.sql'** sendo possível separar as instruções SQL do código PHP. Com isso temos uma melhor legibilidade do código SQL. Instalação ---------- [](#instalação) Como se trata de um pacote composer, basta usar o comando: ``` composer require 'jheferson-br/tquery' ``` Exemplo de Uso -------------- [](#exemplo-de-uso) Para entendermos melhor como a classe funciona, veja este exemplo simples. Suponhamos que precisamos executar a seguinte instrução no banco de dados para limpar as tabelas do sistema: ``` TRUNCATE TABLE cliente; TRUNCATE TABLE produto; TRUNCATE TABLE fornecedor; ``` Que está salvo na pasta **app/querys/** do projeto, no arquivo **LimpaTabelas.sql**. Usando a classe TQuery, ficaria assim: ``` TTransaction::open('ERP'); // instanciando o objeto TQuery. $sql = new TQuery("LimpaTabelas.sql"); //Definindo o local onde os arquivos '.sql' serão encontrados. $sql->setBasePathQuerys("app/querys/"); //Definindo um separador de querys para a execução de varios comandos dentro do mesmo arquivo .sql $sql->setMultiQuerySeparator(";"); //Executando as querys. $afected_rows = $sql->execute(); //Imprimindo na tela a quantidade de linhas que sofreram alterações com a execução da query. print_r($afected_rows); ``` Note que a classe TQuery precisa de uma transação aberta com o **TTransaction** para ser executada, mantendo o padrão do Adianti Framework. Além disso todos os comandos executados com o metodo **execute()** serão logadas no sistema de logs do Adianti. A TQuery também é capaz de excutar querys de consultas, como joins complexos. Muitas vezes utilizar uma View como é recomentando para o framework se torna algo oneroso de dar manutenção. Pensando nisso foi desenvolvido o metodo **load()** que pode receber um **TCriteria** nativo do framework como parâmetro, mantendo a compatibilidade com o framework. Imagine a necessidade de trazer um join complexo como este: ``` SELECT `mes`.`men_mesano` AS `men_mesano`, `mes`.`men_insc_muni` AS `men_insc_muni`, `mes`.`men_conta` AS `men_conta`, `pla`.`pla_bacen`, `mes`.`cod_trib_desif` AS `cod_trib_desif`, SUM(if(COALESCE(`mes`.`men_mes_santer`,0) add(new TFilter('men_mesano', 'LIKE', "%" . date('Y'))); // instanciando o objeto TQuery. $sql = new TQuery("QryRelatorio.sql"); //Definindo o local onde os arquivos '.sql' serão encontrados. $sql->setBasePathQuerys("app/querys/"); //Executando a query e carregando os objetos $rows = $sql->load($criteria); //Imprimindo na tela os resultados da consulta. print_r($rows); ``` Note que a **TQuery** se comporta de forma semelhante a **TRepository** Tambem é possível passar parâmetros para as querys usando mnemônicos customizados. Isso pode ser útil quando queremos enviar um trecho de código SQL para o TQuery incluir na query. Veja: ``` SELECT '12/{{mes_ano}}' AS men_mesano, '{{men_insc_muni}}' AS men_insc_muni, pla_conta AS men_conta, pla.pla_bacen AS pla_bacen, pla.cod_trib_desif AS cod_trib_desif, 0 AS sald_inic, 0 AS men_cred_mes, 0 AS men_deb_mes, 0 AS men_tributavel, 0 AS men_deducao, 0 AS base_calc, 0 AS valr_issqn_retd, 0 AS men_desc_dedu, aliq.`alq_taxa` AS men_aliquota, 0 AS men_incentivo, 0 AS men_desc_incen, 0 AS men_motivo_nao_exig, 0 AS men_processo_nao_exig, 0 AS men_mes_compensacao, 0 AS men_vlr_compensacao, '{{cnpj}}' AS cnpj FROM des_plano AS pla LEFT JOIN des_aliquota AS aliq ON aliq.`cid_cod` = (SELECT cid_cod FROM des_coop WHERE coo_cnpj = '{{cnpj}}') AND aliq.`cod_desif` = pla.`cod_trib_desif` WHERE pla_conta IN (SELECT men_conta FROM des_mensal as mct WHERE ( CAST(CONCAT(SUBSTR(mct.men_mesano, 4,4),SUBSTR(mct.men_mesano, 1,2))AS UNSIGNED INTEGER) between CAST(CONCAT(SUBSTR('01/{{mes_ano}}', 4,4),SUBSTR('01/{{mes_ano}}', 1,2))AS UNSIGNED INTEGER) and CAST(CONCAT(SUBSTR('12/{{mes_ano}}', 4,4),SUBSTR('12/{{mes_ano}}', 1,2))AS UNSIGNED INTEGER) ) and mct.poa_cod = '{{poa_cod}}') AND pla_conta LIKE '7%' and pla.pla_grau = 6 and pla.pla_arquivo = 1 GROUP BY `men_mesano`, men_insc_muni, `men_conta`, `men_aliquota` ``` Note que a query em questão, possui varios mnemônicos customizados como **{{poa\_cod}}** e **{{cnpj}}**Para enviar para a TQuery os dados para seu mineomonico customizado, basta enviar como segundo parametro no construtor do objeto, um array associativo com as chaves mantendo o mesmo nome do mineomonico. Veja um exemplo para a execução da query anterior: ``` TTransaction::open('ERP'); //Definindo os critérios de busca $criteria = new TCriteria(); $criteria->add(new TFilter('men_mesano', 'LIKE', "%" . date('Y'))); //Defininto vetor com mnemônicos customizados $params = [ "mes_ano"=> $mes_ano, "cnpj"=> $PA->cnpj, "poa_cod"=> $PA->poa_cod, "men_insc_muni"=> $PA->insc_muni, ]; // instanciando o objeto TQuery informando os parâmtros q serão utilizados. $sql = new TQuery("QryRelatorio.sql", $params); //Definindo o local onde os arquivos '.sql' serão encontrados. $sql->setBasePathQuerys("app/querys/"); //Executando a query e carregando os objetos $rows = $sql->load($criteria); //Imprimindo na tela os resultados da consulta. print_r($rows); ``` Tambem é possível setar os valores dos mnemônicos atraves do método **setParams** quer recebe como parâmetro o vetor com os valores. Veja como ficaria: ``` $sql->setParams($params); ``` Atenção ======= [](#atenção) #### Nunca use TQuery em telas com inputs de usuários, para a listagem de dados, pois a mesma não possui proteção contra SQL Injection, afinal existe a possibilidade de enviar trechos de códigos para dentro da instrução SQL. [](#nunca-use-tquery-em-telas-com-inputs-de-usuários-para-a-listagem-de-dados-pois-a-mesma-não-possui-proteção-contra-sql-injection-afinal-existe-a-possibilidade-de-enviar-trechos-de-códigos-para-dentro-da-instrução-sql) #### A proteção contra SQL Injection só funciona no método load que recebe um TCretéria que por sua vez, ja tem essa proteção. [](#a-proteção-contra-sql-injection-só-funciona-no-método-load-que-recebe-um-tcretéria-que-por-sua-vez-ja-tem-essa-proteção) #### Então tome cuidado ao implementar a TQuery, para não abrir uma falha de segurança no seu sistema. [](#então-tome-cuidado-ao-implementar-a-tquery-para-não-abrir-uma-falha-de-segurança-no-seu-sistema) #### A TQuery é mais indicada para rotinas internas, sem a interferencia dos usuários. [](#a-tquery-é-mais-indicada-para-rotinas-internas-sem-a-interferencia-dos-usuários) ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community10 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~21 days Recently: every ~31 days Total 7 Last Release 1978d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a7ca938fab2b2a4751c1511efd8b749ebba0408ac17460ddc84072a2a3614a56?d=identicon)[Jheferson](/maintainers/Jheferson) --- Top Contributors [![JhefersonBR](https://avatars.githubusercontent.com/u/25249696?v=4)](https://github.com/JhefersonBR "JhefersonBR (17 commits)") --- Tags adiantiadianti-framework ### Embed Badge ![Health badge](/badges/jheferson-br-tquery/health.svg) ``` [![Health](https://phpackages.com/badges/jheferson-br-tquery/health.svg)](https://phpackages.com/packages/jheferson-br-tquery) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)