rulerz

PenguasaZ

Proyek ini tidak lagi dikelola , hubungi saya jika Anda tertarik menjadi pengelola

Ide sentral dari Spesifikasi adalah untuk memisahkan pernyataan tentang bagaimana mencocokkan seorang kandidat, dari objek kandidat yang dicocokkannya.

Spesifikasinya dijelaskan oleh Eric Evans dan Martin Fowler

RulerZ adalah implementasi PHP dari pola Spesifikasi yang menekankan tiga aspek utama:

• DSL yang mudah dan agnostik data untuk menentukan aturan dan spesifikasi bisnis,
• kemampuan untuk memeriksa apakah seorang kandidat memenuhi spesifikasi,
• kemampuan untuk memfilter atau menanyakan sumber data apa pun untuk hanya mengambil kandidat yang cocok dengan spesifikasi.

Perkenalan

Aturan bisnis dapat ditulis sebagai teks menggunakan bahasa khusus, sangat mirip dengan SQL, dalam hal ini kita menyebutnya sebagai aturan atau dapat diringkas dalam satu kelas dan disebut sebagai spesifikasi .

Setelah aturan (atau spesifikasi) ditulis, aturan tersebut dapat digunakan untuk memeriksa apakah ada kandidat yang memenuhinya atau langsung menanyakan sumber data.

Sumber data berikut didukung secara asli:

• susunan array,
• susunan objek.

Dan dukungan untuk masing-masing hal ini disediakan oleh perpustakaan tambahan:

• Pembuat Kueri DBAL Doktrin: rulez-php/doctrine-dbal,
• Pembuat Kueri ORM Doktrin: rulez-php/doctrine-orm,
• Model Pomm: penggarisz-php/pomm,
• Elasticsearch (menggunakan klien resmi: rulez-php/elasticsearch,
• Solr (menggunakan solarium: rulez-php/solarium,
• ORM Eloquent Laravel: rulez-php/eloquent.

Fitur mematikan: saat bekerja dengan Doctrine, Pomm, atau Elasticsearch, RulerZ dapat mengonversi aturan secara langsung dalam kueri dan tidak perlu mengambil data terlebih dahulu.

Itu keren, tapi kenapa saya membutuhkannya?

Pertama-tama, Anda dapat mengungkapkan aturan bisnis dalam bahasa yang berdedikasi dan sederhana . Kemudian, aturan bisnis ini dapat diringkas dalam kelas spesifikasi, digunakan kembali, dan disusun untuk membentuk aturan yang lebih kompleks. Spesifikasi sekarang dapat digunakan kembali dan diuji . Dan yang tak kalah pentingnya, aturan ini dapat digunakan untuk memeriksa apakah kandidat memenuhi kriteria tersebut dan untuk memfilter sumber data apa pun .

Jika Anda masih perlu yakin, Anda bisa membaca alasannya selengkapnya di artikel ini.

Penggunaan cepat

Sebagai gambaran singkat, kami mengusulkan untuk melihat contoh kecil yang memanipulasi aturan sederhana dan beberapa sumber data.

1. Tuliskan aturannya

Aturan selanjutnya menggambarkan " pemain wanita berperingkat tinggi " (pada dasarnya, pemain wanita yang memiliki lebih dari 9000 poin).

 $ highRankFemalesRule = ' gender = "F" and points > 9000 ' ;

2. Tentukan sumber data

Kami memiliki sumber data berikut:

 // a Doctrine QueryBuilder
$ playersQb = $ entityManager
    -> createQueryBuilder ()
    -> select ( ' p ' )
    -> from ( ' EntityPlayer ' , ' p ' );

// or an array of arrays
$ playersArr = [
    [ ' pseudo ' => ' Joe ' ,   ' gender ' => ' M ' , ' points ' => 2500 ],
    [ ' pseudo ' => ' Moe ' ,   ' gender ' => ' M ' , ' points ' => 1230 ],
    [ ' pseudo ' => ' Alice ' , ' gender ' => ' F ' , ' points ' => 9001 ],
];

// or an array of objects
$ playersObj = [
    new Player ( ' Joe ' ,   ' M ' , 40 , 2500 ),
    new Player ( ' Moe ' ,   ' M ' , 55 , 1230 ),
    new Player ( ' Alice ' , ' F ' , 27 , 9001 ),
];

3. Gunakan aturan untuk menanyakan sumber data

Untuk sumber data kami mana pun, mengambil hasilnya semudah memanggil metode filter :

 // converts the rule in DQL and makes a single query to the DB
$ highRankFemales = $ rulerz -> filter ( $ playersQb , $ highRankFemalesRule );
// filters the array of arrays
$ highRankFemales = $ rulerz -> filter ( $ playersArr , $ highRankFemalesRule );
// filters the array of objects
$ highRankFemales = $ rulerz -> filter ( $ playersObj , $ highRankFemalesRule );

3. (bis) Periksa apakah seorang kandidat memenuhi suatu aturan

Diberikan seorang kandidat, memeriksa apakah memenuhi aturan bermuara pada memanggil metode satisfies :

 $ isHighRankFemale = $ rulerz -> satisfies ( $ playersObj [ 0 ], $ highRankFemalesRule );

Lebih jauh lagi

Lihat dokumentasi untuk mengetahui apa yang RulerZ dapat lakukan untuk Anda.

Lisensi

Perpustakaan ini berada di bawah lisensi MIT.