تنزيل php immutable collections - تنزيل كود مصدر php immutable collections

php immutable collections

فئات أخرى

versions

تنزيل

المجموعات البسيطة والمكتوبة غير القابلة للتغيير لـ PHP

مكتبة توفر مجموعة من المجموعات غير القابلة للتغيير المكتوبة والمنقولة عبر الأنابيب لـ PHP.

متطلبات

بي إتش بي > 7.2

تثبيت

composer require dcsg/php-immutable-collections

ما هي المشاكل التي يحلها هذا؟

عدم وجود الأدوية العامة في PHP لا يسمح بكتابة مجموعات في PHP.

توفر هذه المكتبة مجموعتين مجردتين غير قابلتين للتغيير:

مجموعة القائمة غير القابلة للتغيير - المجموعة غير القابلة للتغيير
مجموعة المجموعة غير القابلة للتغيير - SetImmutableCollection

لماذا كتبت مجموعات غير قابلة للتغيير

المجموعات المكتوبة

نظرًا لأن PHP لا تحتوي على مواد عامة مثل Java، فمن غير الممكن أن يكون لديك مجموعات مكتوبة أصلية. المجموعات المتوفرة في هذه المكتبة هي الأساس الذي يمكنك من خلاله إنشاء مجموعاتك المكتوبة، ما عليك سوى توسيعها.

المجموعات المكتوبة غير القابلة للتغيير لـ DDD (التصميم المعتمد على المجال)

يدور DDD حول جعل التعليمات البرمجية الخاصة بك تتحدث لغة الأعمال، والتي تسمى Ubiquitous Language. بدون المجموعات في PHP، يصعب تحقيق ذلك باستخدام Arrays لأنه لا يمكنك إضافة سلوك إليها. إذن ما يحدث عادةً هو إضافة هذا السلوك إلى كيانك ولكن لا ينبغي أن يكون موجودًا. هناك مشكلة أخرى وهي قابلية تغيير Arrays ، ويجب أن تكون VOs (كائنات القيمة) غير قابلة للتغيير دائمًا وهذا مستحيل مع Arrays ويجب عليك دائمًا التأكد من أن elements تلك Array كلها من نفس النوع.

المجموعات مقابل المصفوفات

تمثل Collections Arrays مجموعة من العناصر.
Collections غير مدعومة أصلاً بواسطة PHP بينما Arrays مدعومة.
Arrays هي بنية بيانات PHP وتستخدم في كل شيء تقريبًا.
لا تسمح لك Arrays بإضافة سلوك جديد بينما تسمح Collections بذلك.
لا تسمح لك Arrays بتحديد نوع لعناصرها بينما تسمح Collections بذلك.

مجموعات PHP أخرى

هناك مجموعات أخرى لـ PHP، على سبيل المثال لا الحصر لدينا مجموعات Doctrine ومجموعات Illuminate. تحل هذه المجموعات مشكلات مختلفة، وهي مصممة خصيصًا لحالة الاستخدام المحددة الخاصة بها، وواجهات برمجة التطبيقات الخاصة بها واسعة النطاق، والأهم من ذلك أن تلك المجموعات قابلة للتغيير. تجعل هذه المجموعات من الصعب استخدام هذه المجموعات في حالات الاستخدام الأكثر بساطة. ولهذا السبب تحتوي المجموعات التي نقدمها هنا على واجهة برمجة تطبيقات صغيرة جدًا ولا تكشف حتى عن واجهة برمجة تطبيقات Iterator. بهذه الطريقة لديك إمكانية استخدامها وتوسيع سلوكها المصمم خصيصًا لاحتياجاتك.

سمات

البناء الثابت لاستخدام الأنابيب.
استخدام أساليب مثل isEmpty , count , contains على get map , filter , slice , merge , reverse toArray 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