Allow Enum constraint to be used as PHP 8.0 Attribute (#50)

* Allow Enum constraint to be used as PHP 8.0 Attribute

* Review testing matrix for wider versions range : PHP 7.1 & Symfony 5.3

* Separate testing model for annotations & attributes testing

* Replace annotations with attributes in doc

Author: yann-eugone

.github/workflows/tests.yml

@@ -14,14 +14,14 @@ jobs:
     strategy:
       matrix:
         include:
-          - php-version: 7.4
+          - php-version: 7.1
             symfony-version: 4.4.*
           - php-version: 8.0
             symfony-version: 4.4.*
-          - php-version: 7.4
-            symfony-version: 5.2.*
+          - php-version: 7.2
+            symfony-version: 5.3.*
           - php-version: 8.0
-            symfony-version: 5.2.*
+            symfony-version: 5.3.*
 
     steps:
       - name: "Checkout"

README.md

@@ -84,13 +84,19 @@ use Yokai\EnumBundle\Validator\Constraints\Enum;
 
 class Member
 {
-    /**
-     * @Enum(StatusEnum::class)
-     */
+     #[Enum(enum: StatusEnum::class)]
     public ?string $status = null;
 }
 ```
 
+> **note** both PHP Attributes & Annotations are supported :
+> ```php
+>     /**
+>      * @Enum(StatusEnum::class)
+>      */
+>     public ?string $status = null;
+> ```
+
 ### Setting up the form
 
 Now that validation is configured, the only thing we have to do is to add a field on our form :
@@ -112,7 +118,7 @@ class MemberType extends AbstractType
     public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         $builder
-            // Because we added the @Enum constraint to Member::$status property
+            // Because we added the #[Enum] constraint to Member::$status property
             // the bundle will be able to find out the appropriate form type automatically
             ->add('status')
         ;

composer.json

@@ -15,9 +15,9 @@
     },
     "require-dev": {
         "doctrine/annotations": "^1.3",
-        "myclabs/php-enum": "^1.8",
-        "phpspec/prophecy-phpunit": "^2.0",
-        "phpunit/phpunit": "^9.4",
+        "myclabs/php-enum": "^1.7",
+        "phpunit/phpunit": "^7.5|^8.5|^9.5",
+        "sensio/framework-extra-bundle": "^5.5|^6.1",
         "squizlabs/php_codesniffer": "^3.5",
         "symfony/form": "^4.4|^5.0",
         "symfony/translation": "^4.4|^5.0",

docs/migrating-from-symfony-standard.md

@@ -28,15 +28,11 @@ class Member
     public const SUBSCRIBE_NEWSLETTER = 'newsletter';
     public const SUBSCRIBE_COMMERCIAL = 'commercial';
 
-    /**
-     * @Assert\NotNull()
-     * @Assert\Choice({Member::STATUS_NEW, Member::STATUS_ACTIVE, Member::STATUS_DISABLED})
-     */
+    #[Assert\NotNull]
+    #[Assert\Choice(choices: [Member::STATUS_NEW, Member::STATUS_ACTIVE, Member::STATUS_DISABLED])]
     public string $status = self::STATUS_NEW;
 
-    /**
-     * @Assert\Choice({Member::SUBSCRIBE_NEWSLETTER, Member::SUBSCRIBE_COMMERCIAL}, multiple=true)
-     */
+    #[Assert\Choice(choices: [Member::SUBSCRIBE_NEWSLETTER, Member::SUBSCRIBE_COMMERCIAL], multiple: true)]
     public array $subscriptions = [];
 }
 ```
@@ -192,17 +188,13 @@ class Member
     public const SUBSCRIBE_NEWSLETTER = 'newsletter';
     public const SUBSCRIBE_COMMERCIAL = 'commercial';
 
-    /**
-     * @Assert\NotNull()
--     * @Assert\Choice({Member::STATUS_NEW, Member::STATUS_ACTIVE, Member::STATUS_DISABLED})
-+     * @Enum(MemberStatusEnum::class)
-     */
+    #[Assert\NotNull]
+-    #[Assert\Choice(choices: [Member::STATUS_NEW, Member::STATUS_ACTIVE, Member::STATUS_DISABLED])]
++    #[Enum(enum: MemberStatusEnum::class)]
     public string $status = self::STATUS_NEW;
 
-    /**
--     * @Assert\Choice({Member::SUBSCRIBE_NEWSLETTER, Member::SUBSCRIBE_COMMERCIAL}, multiple=true)
-+     * @Enum(MemberSubscriptionEnum::class, multiple=true)
-     */
+-    #[Assert\Choice(choices: [Member::SUBSCRIBE_NEWSLETTER, Member::SUBSCRIBE_COMMERCIAL], multiple: true)]
++    #[Enum(enum: MemberSubscriptionEnum::class, multiple: true)]
     public array $subscriptions = [];
 }
 ```

docs/sonata-admin-integration.md

@@ -54,7 +54,7 @@ class MemberAdmin extends AbstractAdmin
     protected function configureFormFields(FormMapper $form): void
     {
         $form
-            // Because we added the @Enum constraint to Member::$status property
+            // Because we added the #[Enum] constraint to Member::$status property
             // the bundle will be able to find out the appropriate form type automatically
             ->add('status')
         ;

src/Validator/Constraints/Enum.php

@@ -12,13 +12,56 @@
  *
  * @author Yann Eugoné <[email protected]>
  */
+#[\Attribute(\Attribute::TARGET_PROPERTY | \Attribute::TARGET_METHOD)]
 final class Enum extends Choice
 {
     /**
      * @var string
      */
     public $enum;
 
+    public function __construct(
+        $enum = null,
+        $callback = null,
+        bool $multiple = null,
+        bool $strict = null,
+        int $min = null,
+        int $max = null,
+        string $message = null,
+        string $multipleMessage = null,
+        string $minMessage = null,
+        string $maxMessage = null,
+        $groups = null,
+        $payload = null,
+        array $options = []
+    ) {
+        if (\is_array($enum)) {
+            // Symfony 4.4 Constraints has single constructor argument containing all options
+            parent::__construct($enum);
+        } else {
+            if (\is_string($enum)) {
+                $this->enum = $enum;
+            }
+
+            // Symfony 5.x Constraints has many constructor arguments for PHP 8.0 Attributes support
+            parent::__construct(
+                null,
+                $callback,
+                $multiple,
+                $strict,
+                $min,
+                $max,
+                $message,
+                $multipleMessage,
+                $minMessage,
+                $maxMessage,
+                $groups,
+                $payload,
+                $options
+            );
+        }
+    }
+
     /**
      * @inheritdoc
      */

tests/Integration/config/packages/annotations.yaml

@@ -0,0 +1,6 @@
+framework:
+    annotations: true
+
+sensio_framework_extra:
+    router:
+        annotations: true

tests/Integration/config/packages/framework.yaml

@@ -1 +1,4 @@
-framework: ~
+framework:
+  test: true
+  form: true
+  property_access: true

tests/Integration/src/Form/PullRequestType.php

@@ -6,8 +6,6 @@
 
 use Symfony\Component\Form\AbstractType;
 use Symfony\Component\Form\FormBuilderInterface;
-use Symfony\Component\OptionsResolver\OptionsResolver;
-use Yokai\EnumBundle\Tests\Integration\App\Model\PullRequest;
 
 /**
  * @author Yann Eugoné <[email protected]>
@@ -19,9 +17,4 @@ public function buildForm(FormBuilderInterface $builder, array $options): void
         $builder->add('status');
         $builder->add('labels');
     }
-
-    public function configureOptions(OptionsResolver $resolver): void
-    {
-        $resolver->setDefault('data_class', PullRequest::class);
-    }
 }

tests/Integration/src/Kernel.php

@@ -4,10 +4,8 @@
 
 namespace Yokai\EnumBundle\Tests\Integration\App;
 
-use Symfony\Bundle\FrameworkBundle\FrameworkBundle;
 use Symfony\Component\Config\Loader\LoaderInterface;
 use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-use Yokai\EnumBundle\YokaiEnumBundle;
 
 /**
  * @author Yann Eugoné <[email protected]>
@@ -16,8 +14,11 @@ final class Kernel extends BaseKernel
 {
     public function registerBundles(): iterable
     {
-        yield new FrameworkBundle();
-        yield new YokaiEnumBundle();
+        yield new \Symfony\Bundle\FrameworkBundle\FrameworkBundle();
+        yield new \Yokai\EnumBundle\YokaiEnumBundle();
+        if (\PHP_VERSION_ID < 80000) {
+            yield new \Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle();
+        }
     }
 
     public function getProjectDir(): string
@@ -27,7 +28,12 @@ public function getProjectDir(): string
 
     public function registerContainerConfiguration(LoaderInterface $loader): void
     {
-        $loader->load($this->getProjectDir() . '/config/packages/');
-        $loader->load($this->getProjectDir() . '/config/services.yaml');
+        $loader->load(__DIR__ . '/../config/packages/framework.yaml');
+        $loader->load(__DIR__ . '/../config/packages/translation.yaml');
+        if (\PHP_VERSION_ID < 80000) {
+            $loader->load(__DIR__ . '/../config/packages/annotations.yaml');
+        }
+
+        $loader->load(__DIR__ . '/../config/services.yaml');
     }
 }