queryflatfile

queryflatfile

• ?? LÉAME en inglés
• ?? README en Francés

Acerca de

queryflatfile es una biblioteca de bases de datos de archivos planos escrita en PHP. Almacena sus datos de forma predeterminada en formato JSON , también admite formatos txt , msgPack e igbinary. Manipule sus datos con un QueryBuilder similar a la sintaxis SQL.

Resumen

• Requisitos
• Instalación
• Ejemplo sencillo
• Métodos
• Uso
• Licencia

Requisitos

versión PHP

Versión PHP	queryflatfile 3.1.x
<= 7,1	✗ No compatible
7,2 / 7,3 / 7,4	✓ Apoyado
8,0/8,1/8,2	✓ Apoyado

Extensiones

• txt para grabar datos con PHP serializar,
• json para grabar datos en formato JSON,
• msgPack para grabar datos en binario.
• igbinary para grabar datos en binario.

Memoria requerida

La cantidad mínima de memoria requerida depende de la cantidad de datos que vayas a procesar y del tipo de operaciones.

Permiso de archivos y directorio.

Permiso para escribir y leer archivos en el directorio que almacenará sus datos.

Instalación

Compositor

Para instalar queryflatfile a través de Composer debes tener el instalador o el archivo binario Composer

Vaya al directorio de su proyecto, abra un símbolo del sistema y ejecute el siguiente comando:

composer require soosyze/ queryflatfile --no-dev

O, si usa el archivo binario,

php composer.phar require soosyze/ queryflatfile --no-dev

Ejemplo sencillo

queryflatfileSchema; use Soosyze queryflatfile Request; use Soosyze queryflatfile TableBuilder; use Soosyze queryflatfile DriverJson; $sch = new Schema(__DIR__ . 'data', 'schema', new Json()); $req = new Request($sch); $sch->createTableIfNotExists('user', function(TableBuilder $table): void { $table->increments('id') $table->string('name') $table->string('firstname')->nullable(); }); $req->insertInto('user', [ 'name', 'firstname' ]) ->values([ 'NOEL', 'Mathieu' ]) ->values([ 'DUPOND', 'Jean' ]) ->values([ 'MARTIN', null ]) ->execute(); $data = $req->select('id', 'name') ->from('user') ->where('firstname', '=', 'Jean') ->fetch(); print_r($data); $sch->dropTableIfExists('user');">

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

use Soosyze  queryflatfile  Schema ;
use Soosyze  queryflatfile  Request ;
use Soosyze  queryflatfile  TableBuilder ;
use Soosyze  queryflatfile  Driver  Json ;

$ sch = new Schema ( __DIR__ . ' data ' , ' schema ' , new Json ());
$ req = new Request ( $ sch );

$ sch -> createTableIfNotExists ( ' user ' , function ( TableBuilder $ table ): void {
    $ table -> increments ( ' id ' )
    $ table -> string ( ' name ' )
    $ table -> string ( ' firstname ' )-> nullable ();
});

$ req -> insertInto ( ' user ' , [ ' name ' , ' firstname ' ])
    -> values ([ ' NOEL ' , ' Mathieu ' ])
    -> values ([ ' DUPOND ' , ' Jean ' ])
    -> values ([ ' MARTIN ' , null ])
    -> execute ();

$ data = $ req -> select ( ' id ' , ' name ' )
    -> from ( ' user ' )
    -> where ( ' firstname ' , ' = ' , ' Jean ' )
    -> fetch ();

print_r ( $ data );

$ sch -> dropTableIfExists ( ' user ' );

El ejemplo anterior generará:

 Array
(
    [id] => 2
    [name] => DUPOND
)

Métodos

Esquema

• dropSchema() ,
• getIncrement( string $tableName ) ,
• getSchema() ,
• getTableSchema( string $tableName ) ,
• hasColumn( string $tableName, $columnName ) ,
• hasTable( string $tableName ) ,
• setConfig( string $host, string $name = 'schema', DriverInterface $driver = null ) .

Mesas de manipulación

• alterTable( string $tableName, callable $callback ) ,
• createTable( string $tableName, callable $callback = null ) ,
• createTableIfNotExists( string $tableName, callable $callback = null ) :
  • boolean( string $name ) ,
  • char( string $name, $length = 1) ,
  • date( string $name ) ,
  • dateTime( string $name ) ,
  • float( string $name ) ,
  • increments( string $name ) ,
  • integer( string $name ) ,
  • string( string $name, $length = 255) ,
  • text( string $name ) .
• dropTable( string $tableName ) ,
• dropTableIfExists( string $tableName ) ,
• truncateTable( string $tableName ) .

Solicitud de selección

• select( string ...$columnNames ) ,
• from( string $tableName ) ,
• leftJoin( string $tableName, Closure|string $column, string $condition = '', string $value = '' ) ,
• rightJoin( string $tableName, Closure|string $column, string $condition = '', string $value = '' ) ,
• union( RequestInterface $union ) ,
• unionAll( RequestInterface $union ) ,
• orderBy( string $columnName, int $order = SORT_DESC|SORT_ASC ) ,
• limit( int $limit, int $offset = 0 ) .

Solicitud de ejecución

• insertInto( string $tableName, array $columnNames ) ,
• values( array $rowValues ) ,
• update( string $tableName, array $row ) ,
• delete() ,
• execute() Realiza la inserción, modificación y eliminación de datos.

Resultado(s) de la consulta

• fetch(): array Devuelve el primer resultado de la consulta,
• fetchAll(): array Devuelve todos los resultados de la consulta,
• lists( string $columnName, string $key = null ): array Devuelve una lista de la columna pasada en el parámetro.

Dónde

• where( string $columnName, string $condition, null|scalar $value ) ,
• orWhere( string $columnName, string $condition, null|scalar $value ) ,
• notWhere( string $columnName, string $condition, null|scalar $value ) ,
• orNotWhere( string $columnName, string $condition, null|scalar $value ) .

Condiciones admitidas (===, ==, !=, <>, <, <=, >, >=, me gusta, me gusta, no me gusta, no me gusta)

Dónde

• whereGroup( Closure $columnName ) ,
• orWhereGroup( Closure $columnName ) ,
• notWhereGroup( Closure $columnName ) ,
• orNotWhereGroup( Closure $columnName ) .

donde entre

• between( string $columnName, $min, $max ) ,
• orBetween( string $columnName, $min, $max ) ,
• notBetween( string $columnName, $min, $max ) ,
• orNotBetween( string $columnName, $min, $max ) .

donde en

• in( string $columnName, array $values ) ,
• orIn( string $columnName, array $values ) ,
• notIn( string $columnName, array $values ) ,
• orNotIn( string $columnName, array $values ) .

¿Dónde estáNull?

• isNull( string $columnName ) ,
• orIsNull( string $columnName ) ,
• isNotNull( string $columnName ) ,
• orIsNotNull( string $columnName ) .

donde expresión regular

• regex( string $columnName, string $pattern ) ,
• orRegex( string $columnName, string $pattern ) ,
• notRegex( string $columnName, string $pattern ) ,
• orNotRegex( string $columnName, string $pattern ) .

Uso

Para ver ejemplos de usos, consulte la documentación del usuario.

Licencia

Este proyecto está bajo la licencia MIT.