Standardize runtime deprecation handling to the doctrine/deprecations library (#2754)

* Standardize runtime deprecation handling to the doctrine/deprecations library

* Update src/Sortable/SortableListener.php

---------

Co-authored-by: Fran Moreno <[email protected]>

Author: mbabker

composer.json

@@ -44,11 +44,11 @@
         "behat/transliterator": "^1.2",
         "doctrine/collections": "^1.2 || ^2.0",
         "doctrine/common": "^2.13 || ^3.0",
+        "doctrine/deprecations": "^1.0",
         "doctrine/event-manager": "^1.2 || ^2.0",
         "doctrine/persistence": "^2.2 || ^3.0",
         "psr/cache": "^1 || ^2 || ^3",
-        "symfony/cache": "^5.4 || ^6.0 || ^7.0",
-        "symfony/deprecation-contracts": "^2.1 || ^3.0"
+        "symfony/cache": "^5.4 || ^6.0 || ^7.0"
     },
     "require-dev": {
         "doctrine/annotations": "^1.13 || ^2.0",

src/DoctrineExtensions.php

@@ -12,6 +12,7 @@
 use Doctrine\Common\Annotations\AnnotationReader;
 use Doctrine\Common\Annotations\PsrCachedReader;
 use Doctrine\Common\Annotations\Reader;
+use Doctrine\Deprecations\Deprecation;
 use Doctrine\ODM\MongoDB\Mapping\Driver as DriverMongodbODM;
 use Doctrine\ORM\Mapping\Driver as DriverORM;
 use Doctrine\Persistence\Mapping\Driver\MappingDriverChain;
@@ -120,10 +121,12 @@ public static function registerAbstractMappingIntoDriverChainMongodbODM(MappingD
      */
     public static function registerAnnotations(): void
     {
-        @trigger_error(sprintf(
+        Deprecation::trigger(
+            'gedmo/doctrine-extensions',
+            'https://github.com/doctrine-extensions/DoctrineExtensions/pull/2558',
             '"%s()" is deprecated since gedmo/doctrine-extensions 3.11 and will be removed in version 4.0.',
             __METHOD__
-        ), E_USER_DEPRECATED);
+        );
 
         // Purposefully no-op'd, all supported versions of `doctrine/annotations` support autoloading
     }

src/Mapping/Annotation/All.php

@@ -7,10 +7,14 @@
  * file that was distributed with this source code.
  */
 
-@trigger_error(sprintf(
+use Doctrine\Deprecations\Deprecation;
+
+Deprecation::trigger(
+    'gedmo/doctrine-extensions',
+    'https://github.com/doctrine-extensions/DoctrineExtensions/pull/2558',
     'Requiring the file at "%s" is deprecated since gedmo/doctrine-extensions 3.11, this file will be removed in version 4.0.',
     __FILE__
-), E_USER_DEPRECATED);
+);
 
 // Contains all annotations for extensions
 // NOTE: should be included with require_once

src/Mapping/Annotation/Blameable.php

@@ -10,6 +10,7 @@
 namespace Gedmo\Mapping\Annotation;
 
 use Doctrine\Common\Annotations\Annotation;
+use Doctrine\Deprecations\Deprecation;
 use Gedmo\Mapping\Annotation\Annotation as GedmoAnnotation;
 
 /**
@@ -42,10 +43,12 @@ final class Blameable implements GedmoAnnotation
     public function __construct(array $data = [], string $on = 'update', $field = null, $value = null)
     {
         if ([] !== $data) {
-            @trigger_error(sprintf(
+            Deprecation::trigger(
+                'gedmo/doctrine-extensions',
+                'https://github.com/doctrine-extensions/DoctrineExtensions/pull/2375',
                 'Passing an array as first argument to "%s()" is deprecated. Use named arguments instead.',
                 __METHOD__
-            ), E_USER_DEPRECATED);
+            );
 
             $args = func_get_args();
 

src/Mapping/Annotation/IpTraceable.php

@@ -10,6 +10,7 @@
 namespace Gedmo\Mapping\Annotation;
 
 use Doctrine\Common\Annotations\Annotation;
+use Doctrine\Deprecations\Deprecation;
 use Gedmo\Mapping\Annotation\Annotation as GedmoAnnotation;
 
 /**
@@ -43,10 +44,12 @@ final class IpTraceable implements GedmoAnnotation
     public function __construct(array $data = [], string $on = 'update', $field = null, $value = null)
     {
         if ([] !== $data) {
-            @trigger_error(sprintf(
+            Deprecation::trigger(
+                'gedmo/doctrine-extensions',
+                'https://github.com/doctrine-extensions/DoctrineExtensions/pull/2377',
                 'Passing an array as first argument to "%s()" is deprecated. Use named arguments instead.',
                 __METHOD__
-            ), E_USER_DEPRECATED);
+            );
 
             $args = func_get_args();
 

src/Mapping/Annotation/Loggable.php

@@ -10,6 +10,7 @@
 namespace Gedmo\Mapping\Annotation;
 
 use Doctrine\Common\Annotations\Annotation;
+use Doctrine\Deprecations\Deprecation;
 use Gedmo\Loggable\LogEntryInterface;
 use Gedmo\Mapping\Annotation\Annotation as GedmoAnnotation;
 
@@ -46,10 +47,12 @@ final class Loggable implements GedmoAnnotation
     public function __construct(array $data = [], ?string $logEntryClass = null)
     {
         if ([] !== $data) {
-            @trigger_error(sprintf(
+            Deprecation::trigger(
+                'gedmo/doctrine-extensions',
+                'https://github.com/doctrine-extensions/DoctrineExtensions/pull/2357',
                 'Passing an array as first argument to "%s()" is deprecated. Use named arguments instead.',
                 __METHOD__
-            ), E_USER_DEPRECATED);
+            );
 
             $args = func_get_args();
 

src/Mapping/Annotation/Reference.php

@@ -10,6 +10,7 @@
 namespace Gedmo\Mapping\Annotation;
 
 use Doctrine\Common\Annotations\Annotation;
+use Doctrine\Deprecations\Deprecation;
 use Gedmo\Mapping\Annotation\Annotation as GedmoAnnotation;
 
 /**
@@ -67,10 +68,12 @@ public function __construct(
         ?string $inversedBy = null
     ) {
         if ([] !== $data) {
-            @trigger_error(sprintf(
+            Deprecation::trigger(
+                'gedmo/doctrine-extensions',
+                'https://github.com/doctrine-extensions/DoctrineExtensions/pull/2389',
                 'Passing an array as first argument to "%s()" is deprecated. Use named arguments instead.',
                 __METHOD__
-            ), E_USER_DEPRECATED);
+            );
 
             $args = func_get_args();
 

src/Mapping/Annotation/ReferenceIntegrity.php

@@ -10,6 +10,7 @@
 namespace Gedmo\Mapping\Annotation;
 
 use Doctrine\Common\Annotations\Annotation;
+use Doctrine\Deprecations\Deprecation;
 use Gedmo\Mapping\Annotation\Annotation as GedmoAnnotation;
 
 /**
@@ -39,10 +40,12 @@ public function __construct($data = [], ?string $value = null)
         if (is_string($data)) {
             $value = $data;
         } elseif ([] !== $data) {
-            @trigger_error(sprintf(
+            Deprecation::trigger(
+                'gedmo/doctrine-extensions',
+                'https://github.com/doctrine-extensions/DoctrineExtensions/pull/2389',
                 'Passing an array as first argument to "%s()" is deprecated. Use named arguments instead.',
                 __METHOD__
-            ), E_USER_DEPRECATED);
+            );
 
             $args = func_get_args();
 

src/Mapping/Annotation/Slug.php

@@ -10,6 +10,7 @@
 namespace Gedmo\Mapping\Annotation;
 
 use Doctrine\Common\Annotations\Annotation;
+use Doctrine\Deprecations\Deprecation;
 use Gedmo\Mapping\Annotation\Annotation as GedmoAnnotation;
 
 /**
@@ -65,10 +66,12 @@ public function __construct(
         string $dateFormat = 'Y-m-d-H:i'
     ) {
         if ([] !== $data) {
-            @trigger_error(sprintf(
+            Deprecation::trigger(
+                'gedmo/doctrine-extensions',
+                'https://github.com/doctrine-extensions/DoctrineExtensions/pull/2379',
                 'Passing an array as first argument to "%s()" is deprecated. Use named arguments instead.',
                 __METHOD__
-            ), E_USER_DEPRECATED);
+            );
 
             $args = func_get_args();
 

src/Mapping/Annotation/SlugHandler.php

@@ -10,6 +10,7 @@
 namespace Gedmo\Mapping\Annotation;
 
 use Doctrine\Common\Annotations\Annotation;
+use Doctrine\Deprecations\Deprecation;
 use Gedmo\Mapping\Annotation\Annotation as GedmoAnnotation;
 use Gedmo\Sluggable\Handler\SlugHandlerInterface;
 
@@ -49,10 +50,12 @@ public function __construct(
         array $options = []
     ) {
         if ([] !== $data) {
-            @trigger_error(sprintf(
+            Deprecation::trigger(
+                'gedmo/doctrine-extensions',
+                'https://github.com/doctrine-extensions/DoctrineExtensions/pull/2379',
                 'Passing an array as first argument to "%s()" is deprecated. Use named arguments instead.',
                 __METHOD__
-            ), E_USER_DEPRECATED);
+            );
 
             $args = func_get_args();