array query

แบบสอบถามอาร์เรย์

แบบสอบถาม Array ช่วยให้คุณสามารถทำการสืบค้นในอาร์เรย์หลายมิติ

ใช้เคส

ห้องสมุดนี้เหมาะสำหรับคุณหากคุณต้องการทำการสืบค้นบางอย่างเกี่ยวกับ:

• อาร์เรย์ PHP แบบคงที่
• อาร์เรย์ที่เก็บไว้ในหน่วยความจำ
• ไฟล์ JSON (หรือ yaml) แยกวิเคราะห์

การใช้งานขั้นพื้นฐาน

ในการสร้างอินสแตนซ์ querybuilder ทำดังต่อไปนี้:

 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 );

ความสอดคล้องของข้อมูล

QueryBuilder ตรวจสอบความสอดคล้องของข้อมูลของคุณ หากตรวจพบความ NotConsistentDataException สอดคล้อง

 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 );

การตรวจสอบการเรียงลำดับและรับผลลัพธ์

คุณสามารถทำการสืบค้นในอาร์เรย์ของคุณ คุณสามารถเชื่อมต่อเกณฑ์:

 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 );

ผู้ให้บริการเกณฑ์ที่มีความสามารถ

• = (ตัวดำเนินการเริ่มต้นสามารถละเว้นได้)
• >
• <
• <=
• >=
• !=
• ARRAY_MATCH
• CONTAINS (กรณีที่ไม่รู้สึก)
• ENDS_WITH
• EQUALS_DATE
• GT_DATE
• GTE_DATE
• IN_ARRAY
• IN_ARRAY_INVERSED
• LT_DATE
• LTE_DATE
• STARTS_WITH

ผู้ให้บริการจัดเรียงที่มีความสามารถ

• ASC (ตัวดำเนินการเริ่มต้นสามารถละเว้นได้)
• DESC
• DATE_ASC
• DATE_DESC

เข้าร่วม

คุณสามารถเข้าร่วมอาร์เรย์ โปรดพิจารณาตัวอย่างเต็มรูปแบบนี้:

 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 ){
    // ...
}

จำกัด และชดเชย

คุณสามารถเพิ่มเกณฑ์และระบุขีด จำกัด และชดเชยสำหรับผลลัพธ์การสืบค้นของคุณ:

 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 ){
    // ...
}

ทำงานกับวันที่

คุณสามารถทำการสืบค้นตามฟิลด์ DateTime คุณสามารถใช้ DATE_ASC หรือ DATE_DESC Operator เพื่อเรียงลำดับผลลัพธ์ตามวันที่ คุณต้องระบุ รูปแบบวันที่ หากรูปแบบของคุณไม่ใช่ YYYY-mm-dd :

 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 ){
    // ...
}

นามแฝง

คุณสามารถใช้นามแฝงโดยใช้คำ as เป็นตัวคั่น ทำสิ่งต่อไปนี้:

 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']
}

ผลการสับเปลี่ยน

คุณสามารถสลับผลลัพธ์การสืบค้นได้โดยใช้วิธีการ getShuffledResults :

 use ArrayQuery  QueryBuilder ;

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

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

ตัวอย่างเพิ่มเติม

โปรดดูที่ QueryBuilderTest สำหรับตัวอย่างเพิ่มเติม

สนับสนุน

หากคุณพบปัญหาหรือมีความคิดโปรดดูที่ส่วนนี้

ผู้เขียน

• Mauro Cassani - GitHub

ใบอนุญาต

โครงการนี้ได้รับใบอนุญาตภายใต้ใบอนุญาต MIT - ดูไฟล์ License.md สำหรับรายละเอียด