ดาวน์โหลด php immutable collections - ดาวน์โหลดคอล php immutable collections ซอร์สโค้ด

php immutable collections

หมวดหมู่อื่นๆ

versions

ดาวน์โหลด

คอลเลกชันที่ไม่เปลี่ยนรูปแบบมินิมอลลิสต์และแบบพิมพ์สำหรับ PHP

ไลบรารีที่จัดเตรียมชุดคอลเลกชันที่ไม่เปลี่ยนรูปแบบเรียบเรียงและแบบไพพ์สำหรับ PHP

ความต้องการ

PHP > 7.2

การติดตั้ง

composer require dcsg/php-immutable-collections

สิ่งนี้แก้ปัญหาอะไรได้บ้าง?

การไม่มี Generics ใน PHP ไม่อนุญาตให้มีการพิมพ์คอลเลกชันใน PHP

ไลบรารีนี้มีคอลเลกชันนามธรรมที่ไม่เปลี่ยนรูปสองชุด:

คอลเลกชันรายการที่ไม่เปลี่ยนรูป - ImmutableCollection
คอลเลกชันชุดที่ไม่เปลี่ยนรูป - SetImmutableCollection

เหตุใดจึงพิมพ์คอลเลกชันที่ไม่เปลี่ยนรูป

คอลเลกชันที่พิมพ์

เนื่องจาก PHP ไม่มี Generics เหมือนกับ Java จึงเป็นไปไม่ได้ที่จะมีคอลเลกชันที่พิมพ์แบบเนทิฟ คอลเลกชันที่มีอยู่ในไลบรารีนี้เป็นรากฐานสำหรับคุณในการสร้างคอลเลกชันประเภทของคุณเอง คุณเพียงแค่ต้องขยายคอลเลกชันเหล่านั้น

คอลเลกชันที่ไม่เปลี่ยนรูปพิมพ์สำหรับ DDD (การออกแบบที่ขับเคลื่อนด้วยโดเมน)

DDD เป็นเรื่องเกี่ยวกับการทำให้โค้ดของคุณพูดภาษาธุรกิจที่เรียกว่า Ubiquitous Language หากไม่มีคอลเลกชันใน PHP การใช้ Arrays จะเป็นเรื่องยากมากเพราะคุณไม่สามารถเพิ่มลักษณะการทำงานให้กับพวกมันได้ ดังนั้นสิ่งที่มักจะเกิดขึ้น คุณเพิ่มพฤติกรรมนั้นให้กับเอนทิตีของคุณ แต่ไม่ควรอยู่ที่นั่น ปัญหาอีกประการหนึ่งคือความไม่แน่นอนของ Arrays , VOs (Value Objects) จะต้อง ไม่เปลี่ยนรูป เสมอและเป็นไปไม่ได้กับ Arrays และคุณควรรับประกันเสมอว่า elements ของ Array นั้นล้วนเป็นประเภทเดียวกัน

คอลเลกชันเทียบกับอาร์เรย์

Collections และ Arrays เป็นตัวแทนของกลุ่มองค์ประกอบ
PHP ไม่รองรับคอ Collections โดยกำเนิดในขณะที่ Arrays รองรับ
Arrays เป็นโครงสร้างข้อมูลของ PHP และใช้สำหรับเกือบทุกอย่าง
Arrays ไม่อนุญาตให้คุณเพิ่มลักษณะการทำงานใหม่ในขณะที่ Collections อนุญาต
Arrays ไม่อนุญาตให้คุณกำหนด ประเภท ขององค์ประกอบในขณะที่ Collections อนุญาต

คอลเลกชัน PHP อื่น ๆ

มีคอลเลกชั่นอื่นๆ สำหรับ PHP ให้เลือกบ้าง เรามี Doctrine Collections และ Illuminate Collections คอลเลกชันเหล่านั้นช่วยแก้ปัญหาที่แตกต่างกัน ได้รับการปรับแต่งให้เหมาะกับกรณีการใช้งานเฉพาะ และ API ของคอลเลกชันนั้นกว้างขวางและที่สำคัญกว่านั้นคือคอลเลกชันเหล่านั้นสามารถเปลี่ยนแปลงได้ การผสมผสานเหล่านี้ทำให้ยากต่อการใช้คอลเลกชันเหล่านั้นเพื่อกรณีการใช้งานที่เรียบง่ายยิ่งขึ้น นั่นเป็นสาเหตุที่คอลเลกชันที่เรานำเสนอที่นี่ มี API ที่เล็กมาก และไม่เปิดเผย Iterator API ด้วยซ้ำ ด้วยวิธีนี้ คุณจะมีโอกาสใช้สิ่งเหล่านี้และขยายลักษณะการทำงานที่ปรับให้เหมาะกับความต้องการของคุณ

คุณสมบัติ

โครงสร้างแบบคงที่สำหรับการใช้งานท่อ
ใช้วิธีต่างๆ เช่น isEmpty , count , toArray , contains , get , map , filter , slice , merge , reverse , reduce , first , last , head , tail

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

การสร้างคอลเลกชันรายการที่พิมพ์

 <?php declare (strict_types= 1 );

use DCSG  ImmutableCollections  ImmutableCollection ;

final class MyStringCollection extends ImmutableCollection {
    protected function validateItems ( array $ elements ): void
    {
        foreach ( $ elements as $ element ) {
            if (! is_string ( $ element )) {
                throw new InvalidArgumentException ( ' Element is not a String. ' );
            }
        }
    }
}

$ collection = MyStringCollection:: create ([ ' foo ' , ' bar ' ]);
echo $ collection -> count (); // 2
$ slicedCollection = $ collection -> slice ( 0 , 1 ); // MyStringCollection { $elements=['foo']}

การสร้างคอลเลกชันชุดที่พิมพ์

 <?php declare (strict_types= 1 );

use DCSG  ImmutableCollections  SetImmutableCollection ;

final class MyStringSetCollection extends SetImmutableCollection {
    protected function validateItems ( array $ elements ): void
    {
        foreach ( $ elements as $ element ) {
            if (! is_string ( $ element )) {
                throw new InvalidArgumentException ( ' Element is not a String. ' );
            }
        }
    }
}

$ collection = MyStringSetCollection:: create ([ ' foo ' , ' bar ' ]);
echo $ collection -> count (); // 2
$ slicedCollection = $ collection -> tail (); // MyStringSetCollection { $elements=['bar']}

$ collection = MyStringSetCollection:: create ([ ' foo ' , ' bar ' , ' foo ' ]); // Throws InvalidArgumentException