如何优雅扩展Symfony Console的TextDescriptor替代核心类？

1. 继承TextDescriptor实现自定义逻辑 #

原TextDescriptor的describeApplication是protected方法，直接继承该类就能重写目标方法，还能添加私有辅助方法，完全覆盖你之前修改vendor的逻辑：

namespace App\Console\Helper;

use Symfony\Component\Console\Descriptor\TextDescriptor;
use Symfony\Component\Console\Application;

class CustomTextDescriptor extends TextDescriptor
{
    protected function describeApplication(Application $application, array $options = []): void
    {
        // 这里写你的自定义输出逻辑，替代原方法的实现
        // 示例：自定义应用标题+保留原有命令列表输出
        $this->writeCustomAppHeader($application);
        parent::describeApplication($application, $options);
    }

    private function writeCustomAppHeader(Application $application): void
    {
        $this->write(sprintf('=== %s (自定义版本) ===', $application->getName()).PHP_EOL.PHP_EOL);
    }
}

2. 替换DescriptorHelper中的默认TextDescriptor #

Symfony Console通过DescriptorHelper管理各种格式的descriptor（text、json、xml等），我们需要替换它默认注册的text类型descriptor：

场景A：Symfony框架应用（依赖DI容器）

先创建自定义的DescriptorHelper子类，在构造方法中替换默认的text descriptor：

namespace App\Console\Helper;

use Symfony\Component\Console\Helper\DescriptorHelper;

class CustomDescriptorHelper extends DescriptorHelper
{
    public function __construct()
    {
        parent::__construct();
        // 用自定义实现替换默认的text类型descriptor
        $this->register('text', new CustomTextDescriptor());
    }
}

然后在config/services.yaml中配置，让DI容器用你的自定义类替换原生服务：

services:
    Symfony\Component\Console\Helper\DescriptorHelper:
        class: App\Console\Helper\CustomDescriptorHelper

场景B：独立Console应用（无DI容器）

在初始化Application实例后，直接替换HelperSet中的descriptor helper：

use App\Console\Helper\CustomDescriptorHelper;
use Symfony\Component\Console\Application;

$app = new Application('My App', '1.0.0');
// 替换默认的descriptor helper
$app->getHelperSet()->set(new CustomDescriptorHelper(), 'descriptor');

// 注册你的命令...
$app->run();

3. 自动生效的原理 #

Console的list命令、命令的--help输出等核心功能，都是通过DescriptorHelper的describe方法调用对应格式的descriptor。替换后，所有依赖原生DescriptorHelper的地方都会自动使用你的CustomTextDescriptor，无需修改原有命令代码。

为什么不用装饰模式？ #

装饰模式只能调用被装饰类的公开方法，无法重写TextDescriptor中的protected方法（比如describeApplication），而继承可以直接重写这些核心逻辑，更贴合你的需求。

内容的提问来源于stack exchange，提问作者pgr