php immutable collections下載 - php immutable collections原始碼下載

php immutable collections

其他類別

versions

下載

PHP 的極簡與類型化不可變集合

一個為 PHP 提供一組簡約、類型化和管道式不可變集合的函式庫。

要求

PHP > 7.2

安裝

composer require dcsg/php-immutable-collections

這解決了什麼問題？

PHP 中缺少泛型，因此不允許在 PHP 中使用類型化集合。

該庫提供了兩個抽象的不可變集合：

不可變列表集合 - ImmutableCollection
不可變集合集合 - SetImmutableCollection

為什麼類型化不可變集合

類型化集合

由於 PHP 不像 Java 那樣具有泛型，因此不可能有本機型別集合。該庫中提供的集合是您創建自己的類型化集合的基礎，您只需擴展它們即可。

DDD（領域驅動設計）的類型化不可變集合

DDD 就是讓您的程式碼使用商業語言，也就是所謂的「無所不在的語言」。如果沒有 PHP 中的集合，使用Arrays就很難實現這一點，因為您無法為它們添加行為。因此，通常會發生的情況是，您將該行為添加到您的實體中，但它不應該在那裡。另一個問題是Arrays的可變性， VOs （值物件）必須始終是不可變的，這對於Arrays來說是不可能的，並且您應該始終保證該Array的elements都是相同的類型。

集合與數組

Collections和Arrays都表示一組元素。
PHP 本身不支援Collections ，而Arrays則支援。
Arrays是 PHP 的資料結構，幾乎用於所有用途。
Arrays不允許添加新行為，而Collections允許。
Arrays不允許為其元素定義類型，而Collections允許。

其他 PHP 集合

還有其他 PHP 集合，其中包括 Doctrine Collections 和 Illuminate Collections。這些集合解決了不同的問題，針對其特定用例進行了定制，並且它們的 API 非常廣泛，更重要的是，這些集合是可變的。這些組合使得很難將這些集合用於更簡單的用例。這就是為什麼我們在這裡提供的 Collections 具有非常小的 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