enum php download - enum php source code download

enum php

فئات أخرى

2.3.0 - PHP 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2

تنزيل

تم إهماله

تحذير إذا كنت تستخدم PHP 8.1 أو أعلى ، فإننا نوصيك باستخدام التعدادات الأصلية PHP بدلاً من هذه الحزمة.
قد نقوم بإصدار بعض تصحيحات الصيانة ولكن يتم إيقاف دعم هذه الحزمة.
لا تتردد في توتر الكود لدينا وتكييفه مع احتياجاتك.

تعداد مكتبة PHP

ملخص

توفر هذه المكتبة تنفيذ التعداد / التعداد لـ PHP.

لماذا تستخدم هذه المكتبة

بسيط جدا للتنفيذ والاستخدام.
يمكن تعيين مجمع اختياريًا عن طريق توفير طريقة map() .
يسمح بمشاهدة النوع عند تمرير القيم المخصصة بين الأساليب والفئات.

الاستخدام

قم أولاً بإنشاء فئة جديدة تمتد RexlabsEnumEnum وافعل ما يلي ؛

أعلن ثوابتك
اختياري : قم بتوفير طريقة map() :

مثال

 <?php

namespace Rexlabs  Enum  Readme ;

use Rexlabs  Enum  Enum ;

/**
 * Class City
 *
 * @package RexlabsEnumReadme
 *
 * @method static static BRISBANE()
 * @method static static MELBOURNE()
 * @method static static SYDNEY()
 */
class City extends Enum
{
    const BRISBANE = ' Brisbane ' ;
    const MELBOURNE = ' Melbourne ' ;
    const SYDNEY = ' Sydney ' ;
    
    // OPTIONAL - Provide a map() method if you would like to
    // map additional data, which will be available from the ->value() method
    public static function map (): array 
    {
        return [
            self :: BRISBANE => [ " state " => " QLD " , " population " => "" ],
            self :: MELBOURNE => [ " state " => " VIC " , " population " => " 5m " ],
            self :: SYDNEY => [ " state " => " NSW " , " population " => " 5m " ],
        ];
    }
    
}

// Static access
echo City:: BRISBANE ;                 // "Brisbane"
echo City:: MELBOURNE ;                // "Melbourne"
City:: names ();                       // (array)["BRISBANE", "BRISBANE", "SYDNEY"]
City:: keys ();                        // (array)["Brisbane", "Melbourne", "Sydney"]
City:: keyForName ( ' BRISBANE ' );        // "Brisbane"
City:: nameForKey ( ' Melbourne ' );       // "MELBOURNE"
City:: isValidKey ( ' Sydney ' );          // (boolean)true
City:: isValidKey ( ' Paris ' );           // (boolean)false
               
// Getting an instance - all return a City instance.
$ city = City:: BRISBANE ();                   
$ city = City:: instanceFromName ( ' BRISBANE ' ); 
$ city = City:: instanceFromKey ( ' Brisbane ' );

// Working with an instance
$ city -> name ();                       // "BRISBANE"
$ city -> key ();                        // "Brisbane"
$ city -> value ()[ ' population ' ];        // null - no value mapped
$ city -> is (City:: BRISBANE );           // (boolean)true
$ city -> is (City:: BRISBANE ());         // (boolean)true
$ city -> is (City:: SYDNEY ());           // (boolean)false
$ city -> isNot (City:: SYDNEY ());        // (boolean)true
$ city -> isAnyOf ([City:: BRISBANE ()]);  // (boolean)true
$ city -> isNoneOf ([City:: BRISBANE ()]); // (boolean)false

// Or ...
City:: SYDNEY ()-> key ();               // "Sydney"
City:: SYDNEY ()-> value ();             // (array)["state"=>"NSW", "population"=>"5m"]

التبعيات

PHP 7.0 أو أعلى.

تثبيت

للتثبيت في مشروعك:

composer require rexlabs/enum

الكتابة

يمكنك الآن كتابة كائن Enum الخاص بك باعتباره تبعية:

 <?php
function announceCity ( City $ city ) {
    echo "{ $ city -> key ()} is located in { $ city -> value ()[ " state " ]} , population: { $ city -> value ()[ " population " ]}n" ;
}

// Get a new instance
announceCity (City:: SYDNEY ());      // "Sydney is located in NSW, population: 5m"

طرق مثيل

يوفر كل مثيل من Enum الطرق التالية:

اسم()

إرجاع الاسم الثابت.

 $ enum -> name ();

مفتاح()

إرجاع القيمة/المفتاح المعين إلى الثابت في إعلان const MY_CONST = 'key' .

 $ enum -> key ();

قيمة()

إرجاع القيمة (if-iny) التي يتم تعيينها (في الصفيف الذي تم إرجاعه بواسطة map() ). إذا لم يتم تعيين قيمة ، فإن هذه الطريقة تُرجع null .

 $ enum -> value ();

IS (enum | string $ مقارنة)

إرجاع صحيح إذا كان هذا المثيل هو نفسه المفتاح الثابت أو مثيل التعداد المعطى.

 $ enum -> is (City:: SYDNEY );       // Compare to constant key
$ enum -> is (City:: SYDNEY ());     // Compare to instance

__tostring ()

يتم تعريف طريقة __toString() لإرجاع الاسم الثابت.

( string )City:: SYDNEY ();      // "SYDNEY"

طرق ثابتة

رسم خريطة()

إرجاع صفيف يقوم بتخطيط المفاتيح الثابتة إلى القيمة. يمكن تنفيذ هذه الطريقة اختياريًا في فئة فرعية. يقوم التنفيذ الافتراضي بإرجاع مجموعة من المفاتيح المعينة إلى null .