Improved the clear-caches/cp-resources error

Resolves #7286
craftcms · Dec 22, 2020 · 5dbcd71 · 5dbcd71
1 parent 9f390f7
commit 5dbcd71
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 1 deletion.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,8 @@
 # Release Notes for Craft CMS 3.x
 
+### Changed
+- Improved the error message that is output when running the `clear-caches/cp-resources` command, if the `@webroot` alias isn’t explicitly set. ([#7286](https://github.com/craftcms/cms/issues/7286))
+
 ## 3.5.17.1 - 2020-12-17
 
 ### Fixed

diff --git a/src/utilities/ClearCaches.php b/src/utilities/ClearCaches.php
@@ -168,7 +168,9 @@ public static function cacheOptions(): array
                         $request->isWebrootAliasSetDynamically &&
                         strpos($basePath, '@webroot') === 0
                     ) {
-                        throw new \Exception('Unable to clear control panel resources because the location isn\'t known for console commands.');
+                        throw new \Exception("Unable to clear control panel resources because the location isn't known for console commands.\n" .
+                            "Explicitly set the @webroot alias in config/general.php to avoid this error.\n" .
+                            'See https://craftcms.com/docs/3.x/config/#aliases for more info.');
                     }
 
                     FileHelper::clearDirectory(Craft::getAlias($basePath), [