Add a hardDeprecationErrors setting (default false) that throws an ex…

…ception if a deprecation error is logged

Signed-off-by: Andrew Welch <[email protected]>

src/config/GeneralConfig.php

@@ -352,6 +352,10 @@ class GeneralConfig extends BaseObject
      * @var bool Whether images transforms should be generated before page load.
      */
     public $generateTransformsBeforePageLoad = false;
+    /**
+     * @var bool Whether logged deprecation errors should throw an exception.
+     */
+    public $hardDeprecationErrors = false;
     /**
      * @var mixed The image driver Craft should use to cleanse and transform images. By default Craft will auto-detect if ImageMagick is installed and fallback to GD if not. You can explicitly set
      * either `'imagick'` or `'gd'` here to override that behavior.

src/errors/DeprecationException.php

@@ -0,0 +1,27 @@
+<?php
+/**
+ * @link https://craftcms.com/
+ * @copyright Copyright (c) Pixel & Tonic, Inc.
+ * @license https://craftcms.github.io/license/
+ */
+
+namespace craft\errors;
+
+use yii\base\UserException;
+
+/**
+ * Class FileException
+ *
+ * @author Pixel & Tonic, Inc. <[email protected]>
+ * @since 3.0
+ */
+class DeprecationException extends UserException
+{
+    /**
+     * @return string the user-friendly name of this exception
+     */
+    public function getName()
+    {
+        return 'Deprecation Error Exception';
+    }
+}

src/services/Deprecator.php

@@ -11,6 +11,7 @@
 use craft\db\Query;
 use craft\db\Table;
 use craft\elements\db\ElementQuery;
+use craft\errors\DeprecationException;
 use craft\helpers\Db;
 use craft\helpers\Json;
 use craft\helpers\StringHelper;
@@ -127,6 +128,10 @@ public function log(string $key, string $message, string $file = null, int $line
         } catch (IntegrityException $e) {
             // todo: remove this try/catch after the next breakpoint
         }
+        // Throw an exception if $hardDeprecationErrors is true
+        if (Craft::$app->getConfig()->getGeneral()->hardDeprecationErrors) {
+            throw new DeprecationException($message);
+        }
     }
 
     /**