abhi1693 / yii2-enum
Enumerable Helper
Fund package maintenance!
abhi1693
paypal.me/AbhimanyuSaharan
Installs: 12 030
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 4
Forks: 2
Open Issues: 0
Type:yii2-extension
Requires
- yiisoft/yii2: *
This package is not auto-updated.
Last update: 2024-11-09 17:40:26 UTC
README
Documentation
Installation
The preferred way to install this extension is through composer.
Either run
php composer.phar require --prefer-dist abhi1693/yii2-enum "1.0.0"
or add
"abhi1693/yii2-enum": "1.0.0"
to the require section of your composer.json
file.
Usage
The BaseEnum
class provides support for enumerated types. The class also provides functionality that may be useful in the course of creating and validation enums. To make use of it, you simply create your own class that extends BaseEnum
:
use abhimanyu\enum\helpers; class Month extends BaseEnum { const January = 1; const February = 2; const March = 3; const April = 4; const May = 5; const June = 6; const July = 7; const August = 8; const September = 9; const October = 10; const November = 11; const December = 12; }
There are multiple ways to create a new value for an enumerated type:
// static call $month = Month::May(); // direct instantiation $month = new Month(Month::May); // by value $month = Month::createByValue(5); // by name $month = Month::createByName('May');
It is possible to retrieve the name and value of the instance of the enumerated type:
$name = $month->getName(); $value = $month->getValue();
NOTE: If you have multiple class constants defined with the same value, then an array of names will be returned instead of a string for only one. It will be up to you to decide which to use.
The class also provides ways of validating names and values:
if (Month::isValidName('May')) { // it is valid } if (Month::isValidValue($value)) { // it is valid }
If you need to retrieve a complete list of possible enum values, you can get them either by name or value:
$constantsByName = Month::getConstantsByName(); echo $constantsByName['May']; // 5 $constantsByValue = Month::getConstantsByValue(); echo $constantsByValue[5]; // "May"
How to contribute?
Contributing instructions are located in CONTRIBUTING.md file.
License
Yii2-Enum is released under the MIT License. See the bundled LICENSE for details.