array query

Array -Abfrage

Mit Array Query können Sie Fragen zu mehrdimensionalen Arrays ausführen.

Anwendungsfälle

Diese Bibliothek ist für Sie geeignet, wenn Sie einige Fragen ausführen müssen:

• Statische PHP -Arrays
• In-Memory gespeicherte Arrays
• Analyse JSON (oder YAML) -Dateien

Grundnutzung

Um den QueryBuilder zu instanziieren, machen Sie Folgendes:

 use ArrayQuery  QueryBuilder ;

$ array = [
    [
        ' id ' => 1 ,
        ' title ' => ' Leanne Graham ' ,
        ' email ' => ' [email protected] ' ,
        ' rate ' => 5 ,
        ' company ' => [
            ' name ' => ' Romaguera-Jacobson ' ,
            ' catchPhrase ' => ' Face to face bifurcated interface ' ,
            ' bs ' => ' e-enable strategic applications '
        ]
    ],
    [
        ' id ' => 2 ,
        ' title ' => ' Ervin Howell ' ,
        ' email ' => ' [email protected] ' ,
        ' rate ' => 3 ,
        ' company ' => [
            ' name ' => ' Robel-Corkery ' ,
            ' catchPhrase ' => ' Multi-tiered zero tolerance productivity ' ,
            ' bs ' => ' transition cutting-edge web services '
        ]
    ],
    [
        ' id ' => 3 ,
        ' title ' => ' Clementine Bauch ' ,
        ' email ' => ' [email protected] ' ,
        ' rate ' => 4 ,
        ' company ' => [
            ' name ' => ' Keebler LLC ' ,
            ' catchPhrase ' => ' User-centric fault-tolerant solution ' ,
            ' bs ' => ' revolutionize end-to-end systems '
        ]
    ],
    // ..
]

QueryBuilder:: create ( $ array );

// to add an element to your array. Do this BEFORE make a query on the array
$ element = [
   ' id ' => 4 ,
   ' title ' => ' Patricia Lebsack ' ,
   ' email ' => ' [email protected] ' ,
   ' rate ' => 2 ,
   ' company ' => [
       ' name ' => ' Robel-Corkery ' ,
       ' catchPhrase ' => ' Multi-tiered zero tolerance productivity ' ,
       ' bs ' => ' transition cutting-edge web services '
   ]
];
$ qb -> addElement ( $ element , 4 );

// to remove an element from array by his key. Do this BEFORE make a query on the array
$ qb -> removeElement ( 3 );

Datenkonsistenz

QueryBuilder überprüft Ihre Datenkonsistenz. Wenn eine Inkonsistenz festgestellt wird, wird eine NotConsistentDataException DataException angehoben:

 use ArrayQuery  QueryBuilder ;

$ array = [
    [
        ' id ' => 1 ,
        ' title ' => ' Leanne Graham ' ,
        ' email ' => ' [email protected] ' ,
        ' rate ' => 5 ,
        ' company ' => [
            ' name ' => ' Romaguera-Jacobson ' ,
            ' catchPhrase ' => ' Face to face bifurcated interface ' ,
            ' bs ' => ' e-enable strategic applications '
        ]
    ],
    [
        ' id ' => 2 ,
        ' title ' => ' Ervin Howell ' ,
        ' email ' => ' [email protected] ' ,
        ' rate ' => 3 ,
        ' company ' => [
            ' name ' => ' Robel-Corkery ' ,
            ' catchPhrase ' => ' Multi-tiered zero tolerance productivity ' ,
            ' bs ' => ' transition cutting-edge web services '
        ]
    ],
    [
        ' id ' => 3 ,
        ' title ' => ' Clementine Bauch ' ,
        ' email ' => ' [email protected] ' ,
        ' rate ' => 4 ,
        ' company ' => [
            ' name ' => ' Keebler LLC ' ,
            ' catchPhrase ' => ' User-centric fault-tolerant solution ' ,
            ' bs ' => ' revolutionize end-to-end systems '
        ],
        ' extra-field ' => ' this is an extra field '
    ],
]

// NotConsistentDataException will be raised
QueryBuilder:: create ( $ array );

Befragen, Sortieren und Ergebnisse erzielen

Sie können Abfragen in Ihrem Array ausführen. Sie können Kriterien verkettet:

 use ArrayQuery  QueryBuilder ;

// ..

$ qb = QueryBuilder:: create ( $ array );
$ qb
    -> addCriterion ( ' title ' , ' Leanne ' , ' CONTAINS ' )
    -> addCriterion ( ' rate ' , ' 3 ' , ' > ' )
    -> sortedBy ( ' title ' , ' DESC ' );

// you can search by nested keys    
$ qb -> addCriterion ( ' company.name ' , ' Romaguera-Jacobson ' );

// get results    
foreach ( $ qb -> getResults () as $ element ){
    // ...
}

// get first result
$ first = $ qb -> getFirstResult ();

// get last result
$ last = $ qb -> getLastResult ();

// get a result by index
$ thirdResult = $ qb -> getResult ( 3 );

Avalierkriterienbetreiber

• = (Standardoperator kann weggelassen werden)
• >
• <
• <=
• >=
• !=
• ARRAY_MATCH
• CONTAINS (Fall unempfindlich)
• ENDS_WITH
• EQUALS_DATE
• GT_DATE
• GTE_DATE
• IN_ARRAY
• IN_ARRAY_INVERSED
• LT_DATE
• LTE_DATE
• STARTS_WITH

Avaliable Sortierbetreiber

• ASC (Standardoperator kann weggelassen werden)
• DESC
• DATE_ASC
• DATE_DESC

Schließt sich an

Sie können Arrays beitreten. Bitte betrachten Sie dieses vollständige Beispiel:

 use ArrayQuery  QueryBuilder ;

$ users = [
    [
        ' id ' => 1 ,
        ' name ' => ' Mauro Cassani ' ,
        ' id_category ' => 3 ,
        ' email ' => ' [email protected] '
    ],[
        ' id ' => 2 ,
        ' name ' => ' Mario Rossi ' ,
        ' id_category ' => 3 ,
        ' email ' => ' [email protected] '
    ],[
        ' id ' => 3 ,
        ' name ' => ' Maria Bianchi ' ,
        ' id_category ' => 1 ,
        ' email ' => ' [email protected] '
    ]
];
$ category = [
    ' id ' => 3 ,
    ' name ' => ' Web Developer '
];

$ qb = QueryBuilder:: create ( $ users )
    -> join ( $ category , ' category ' , ' id_category ' , ' id ' )
    -> addCriterion ( ' category.id ' , 3 );

foreach ( $ qb -> getResults () as $ element ){
    // ...
}

Begrenzung und Offset

Sie können Kriterien hinzufügen und Limit und Offset für Ihre Abfrageergebnisse angeben:

 use ArrayQuery  QueryBuilder ;

$ qb = QueryBuilder:: create ( $ array );
$ qb
    -> addCriterion ( ' title ' , [ ' Leanne ' ], ' IN_ARRAY ' )
    -> addCriterion ( ' rate ' , ' 3 ' , ' > ' )
    -> sortedBy ( ' title ' )
    -> limit ( 0 , 10 );

foreach ( $ qb -> getResults () as $ element ){
    // ...
}

Arbeiten mit Daten

Sie können Abfragen basierend auf DateTime -Feldern ausführen. Sie können DATE_ASC oder DATE_DESC -Operator verwenden, um die Ergebnisse nach Datum zu sortieren. Sie müssen das Datumsformat angeben, wenn Ihr Format nicht YYYY-mm-dd ist:

 use ArrayQuery  QueryBuilder ;

$ qb = QueryBuilder:: create ( $ array );
$ qb
    -> addCriterion ( ' registration_date ' , ' 01/05/2017 ' , ' GT_DATE ' , ' d/m/Y ' )
    -> addCriterion ( ' rate ' , ' 3 ' , ' > ' )
    -> sortedBy ( ' registration_date ' , ' DATE_DESC ' , ' d/m/Y ' )
    -> limit ( 0 , 10 );

foreach ( $ qb -> getResults () as $ element ){
    // ...
}

Aliase

Sie können Aliase verwenden, indem Sie das Keyword as Trennzeichen verwenden. Folgendes machen:

 use ArrayQuery  QueryBuilder ;

$ qb = QueryBuilder:: create ( $ array );
$ qb
    -> addCriterion ( ' name as n ' , ' Ervin Howell ' )
    -> addCriterion ( ' username as user ' , ' Antonette ' )
    -> addCriterion ( ' address.street as street ' , ' Victor Plains ' );

foreach ( $ qb -> getResults () as $ element ){
    // ...
    // now you have
    // $element['n']
    // $element['user']
    // $element['street']
}

Geschaltete Ergebnisse

Sie können die Ergebnisse der Abfragen mit der Methode getShuffledResults -Methoden mischen:

 use ArrayQuery  QueryBuilder ;

$ qb = QueryBuilder:: create ( $ array );

foreach ( $ qb -> getShuffledResults () as $ element ){
    // ...
}

Weitere Beispiele

Weitere Beispiele finden Sie in QueryBuilderTest.

Unterstützung

Wenn Sie ein Problem gefunden haben oder eine Idee hatten, lesen Sie bitte diesen Abschnitt.

Autoren

• Mauro Cassani - Github

Lizenz

Dieses Projekt ist unter der MIT -Lizenz lizenziert - finden Sie in der lizenz.md -Datei für Details