Add Symfony Console 8 support (#233)

Author: vjik

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ## 2.4.2 under development
 
-- no changes in this release.
+- Enh #233: Add Symfony Console 8 support (@vjik)
 
 ## 2.4.1 December 02, 2025
 

composer.json

@@ -31,13 +31,12 @@
         "psr/container": "^1.0 || ^2.0",
         "psr/event-dispatcher": "^1.0",
         "psr/log": "^1.0 || ^2.0 || ^3.0",
-        "symfony/console": "^5.4 || ^6.0 || ^7.0",
+        "symfony/console": "^5.4 || ^6.0 || ^7.0 || ^8.0",
         "symfony/event-dispatcher-contracts": "^2.2 || ^3.0",
         "yiisoft/friendly-exception": "^1.0"
     },
     "require-dev": {
         "bamarni/composer-bin-plugin": "^1.8.3",
-        "maglnet/composer-require-checker": "^4.4",
         "phpunit/phpunit": "^9.6.22",
         "rector/rector": "^2.0.11",
         "yiisoft/config": "^1.5",

src/CommandLoader.php

@@ -5,7 +5,9 @@
 namespace Yiisoft\Yii\Console;
 
 use Psr\Container\ContainerInterface;
+use ReflectionClass;
 use RuntimeException;
+use Symfony\Component\Console\Attribute\AsCommand;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Command\LazyCommand;
 use Symfony\Component\Console\CommandLoader\CommandLoaderInterface;
@@ -31,6 +33,8 @@ final class CommandLoader implements CommandLoaderInterface
      */
     private array $commandNames;
 
+    private ?bool $symfonyConsoleVersionLess8 = null;
+
     /**
      * @param array $commandMap An array with command names as keys and service ids as values.
      *
@@ -52,12 +56,7 @@ public function get(string $name): Command
         $commandClass = $this->commandMap[$name]['class'];
         $commandHidden = $this->commandMap[$name]['hidden'];
 
-        /**
-         * @see https://github.com/yiisoft/yii-console/issues/229
-         * @psalm-suppress DeprecatedMethod
-         */
-        $description = $commandClass::getDefaultDescription();
-
+        $description = $this->getCommandDescription($commandClass);
         if ($description === null) {
             return $this->getCommandInstance($name);
         }
@@ -154,4 +153,27 @@ private function validateAliases(array $aliases): void
             }
         }
     }
+
+    /**
+     * @psalm-param class-string<Command> $commandClass
+     */
+    private function getCommandDescription(string $commandClass): ?string
+    {
+        $this->symfonyConsoleVersionLess8 ??= method_exists(Command::class, 'getDefaultDescription');
+
+        if ($this->symfonyConsoleVersionLess8) {
+            /**
+             * @see https://github.com/yiisoft/yii-console/issues/229
+             * @psalm-suppress DeprecatedMethod, UndefinedMethod
+             * @var string|null
+             */
+            return $commandClass::getDefaultDescription();
+        }
+
+        if ($attribute = (new ReflectionClass($commandClass))->getAttributes(AsCommand::class)) {
+            return $attribute[0]->newInstance()->description;
+        }
+
+        return null;
+    }
 }

tools/composer-require-checker/composer.json

@@ -0,0 +1,5 @@
+{
+    "require-dev": {
+        "maglnet/composer-require-checker": "^4.4"
+    }
+}