marc-mabe / enum-cl
Compatibility layer for emulating enumerations in PHP < 8.1 and native enumerations in PHP >= 8.1
Installs: 3 649
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 4
Forks: 1
Open Issues: 0
Requires
- php: ^7.1 | ^8.0
- composer-runtime-api: ^2.0
- ext-reflection: *
Requires (Dev)
- phpstan/phpstan: ^1.3.0
- phpunit/phpunit: ^7.5.20 | ^8.5.22 | ^9.5.11
- vimeo/psalm: ^4.17.0
This package is auto-updated.
Last update: 2024-11-18 23:12:51 UTC
README
How-to create
Vendor\MyEnum.php
<?php declare(strict_types=1); if (PHP_VERSION_ID < 80100) { require_once __DIR__ . '/MyEnum-emulated.php'; } else { require_once __DIR__ . '/MyEnum-native.php'; }
Vendor\MyEnum-emulated.php
<?php declare(strict_types=1); namespace Vendor; use Mabe\Enum\Cl\EmulatedIntEnum; final class MyEnum extends EmulatedIntEnum { protected const ZERO = 0; protected const ONE = 1; protected const TWO = 2; protected const THREE = 3; protected const FOUR = 4; protected const FIVE = 5; protected const SIX = 6; protected const SEVEN = 7; protected const EIGHT = 8; protected const NINE = 9; }
Vendor\MyEnum-native.php
<?php declare(strict_types=1); namespace Vendor; use Mabe\Enum\Cl\EnumBc; enum MyEnum:int { use EnumBc; case ZERO = 0; case ONE = 1; case TWO = 2; case THREE = 3; case FOUR = 4; case FIVE = 5; case SIX = 6; case SEVEN = 7; case EIGHT = 8; case NINE = 9; }
For IDE and static code analyzers I recommend adding the following docblock:
/** * @method static self CASENAME() */
How-to use
The following will work the same on PHP<8.1 (using emulated enums) and on PHP>=8.1 (using native enums):
<?php declare(strict_types=1); namespace Vendor; use function Mabe\Enum\Cl\enum_exists; $zero = MyEnum::ZERO(); $zero = MyEnum::from(0); $zero = MyEnum::tryFrom(0); $cases = MyEnum::cases(); $zero->value; // 0 $zero->name; // ZERO $zero instanceof \UnitEnum; // true $zero instanceof \BackedEnum; // true MyEnum::ZERO() === MyEnum::from(0); // true MyEnum::from(0) === MyEnum::tryFrom(0); // true enum_exists(MyEnum::class); // true enum_exists('stdClass'); // false
Warning: The following will not behave the same on all PHP versions:
<?php declare(strict_types=1); namespace Vendor; MyEnum::ZERO; // PHP<8.1: Error: Cannot access protected const MyEnum::ZERO // PHP>=8.1: enum(MyEnum::ZERO) serialize(MyEnum::ZERO()); // PHP<8.1: Error: Trying to serialize a non serializable emulated enum case of MyEnum // PHP>=8.1: "E:11:"MyEnum:ZERO"
Additional Notes
PHPStan
By default PHPStan will complain about unused constants as it can't automatically detect the special use via reflection in this case.
To avoid this you need to add the following to your phpstan.neon[.dist]
:
services:
-
class: Mabe\Enum\Cl\PHPStan\ConstantExtension
tags:
- phpstan.constants.alwaysUsedClassConstantsExtension
For more information please read https://phpstan.org/developing-extensions/always-used-class-constants
Included Polyfills
This library includes the following polyfills (if not already present):
get_debug_type