sql parser

sql parser

Un analizador y lexador de validación de SQL centrado en el dialecto MySQL.

Estado del código

Instalación

Utilice Composer para instalar:

composer require phpmyadmin/sql-parser

Documentación

La documentación de la API está disponible en https://develdocs.phpmyadmin.net/sql-parser/.

Uso

Utilidades de línea de comando

Utilidad de línea de comando para resaltar la sintaxis de la consulta SQL:

./vendor/bin/sql-parser --highlight --query " SELECT 1 "

Utilidad de línea de comando para eliminar consultas SQL:

./vendor/bin/sql-parser --lint --query " SELECT 1 "

Utilidad de línea de comando para tokenizar consultas SQL:

./vendor/bin/sql-parser --tokenize --query " SELECT 1 "

Todos los comandos pueden analizar la entrada desde stdin (entrada estándar), como por ejemplo:

 echo " SELECT 1 " | ./vendor/bin/sql-parser --highlight
cat example.sql | ./vendor/bin/sql-parser --lint

Formatear consulta SQL

 echo PhpMyAdmin  SqlParser  Utils Formatter:: format ( $ query , [ ' type ' => ' html ' ]);

Descubriendo el tipo de consulta

 use PhpMyAdmin  SqlParser  Parser ;
use PhpMyAdmin  SqlParser  Utils  Query ;

$ query = ' OPTIMIZE TABLE tbl ' ;
$ parser = new Parser ( $ query );
$ flags = Query:: getFlags ( $ parser -> statements [ 0 ]);

echo $ flags -> queryType ?->value;

Analizar y crear consultas SQL

 require __DIR__ . ' /vendor/autoload.php ' ;

$ query1 = ' select * from a ' ;
$ parser = new PhpMyAdmin  SqlParser  Parser ( $ query1 );

// inspect query
var_dump ( $ parser -> statements [ 0 ]); // outputs object(PhpMyAdminSqlParserStatementsSelectStatement)

// modify query by replacing table a with table b
$ table2 = new  PhpMyAdmin  SqlParser  Components  Expression ( '' , ' b ' , '' , '' );
$ parser -> statements [ 0 ]-> from [ 0 ] = $ table2 ;

// build query again from an array of object(PhpMyAdminSqlParserStatementsSelectStatement) to a string
$ statement = $ parser -> statements [ 0 ];
$ query2 = $ statement -> build ();
var_dump ( $ query2 ); // outputs string(19) 'SELECT  * FROM `b` '

// Change SQL mode
PhpMyAdmin  SqlParser Context:: setMode ( PhpMyAdmin  SqlParser Context:: SQL_MODE_ANSI_QUOTES );

// build the query again using different quotes
$ query2 = $ statement -> build ();
var_dump ( $ query2 ); // outputs string(19) 'SELECT  * FROM "b" ' 

Localización

Puede localizar mensajes de error instalando phpmyadmin/motranslator versión 5.0 o posterior:

composer require phpmyadmin/motranslator:^5.0

La configuración regional se detecta automáticamente desde su entorno; también puede configurar una configuración regional diferente

De cli :

LC_ALL=pl ./vendor/bin/sql-parser --lint --query " SELECT 1 "

Desde php :

 require __DIR__ . ' /vendor/autoload.php ' ;

PhpMyAdmin  SqlParser Translator:: setLocale ( ' pl ' );

$ query1 = ' select * from a ' ;
$ parser = new PhpMyAdmin  SqlParser  Parser ( $ query1 );

Más información

Esta biblioteca se creó originalmente durante Google Summer of Code 2015 y phpMyAdmin la ha utilizado desde la versión 4.5.