如何禁用Symfony项目中Doctrine的doctrine:schema:update命令？

为什么你之前的方法无效？ #

• 继承命令类但未设置优先级：Symfony命令优先级默认相同，默认命令会先被注册，导致自定义覆盖失效
• 设置public: false没用：Console组件通过console.command标签收集命令，和服务是否公开无关
• 指定不存在类但没找对服务ID：必须精准覆盖Doctrine命令的服务IDdoctrine.orm.command.schema_update，否则默认服务依然存在

方法1：自定义命令覆盖并抛出明确错误 #

创建优先级更高的自定义命令，直接阻断原命令执行：

// src/Command/DisabledUpdateSchemaCommand.php
namespace App\Command;

use Doctrine\ORM\Tools\Console\Command\UpdateSchemaCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Console\Style\SymfonyStyle;

class DisabledUpdateSchemaCommand extends UpdateSchemaCommand
{
    protected static $defaultName = UpdateSchemaCommand::COMMAND_NAME;
    // 设置更高优先级，确保覆盖默认命令
    protected static $defaultPriority = 10;

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $io = new SymfonyStyle($input, $output);
        $io->error('禁止使用`doctrine:schema:update`命令，请使用Doctrine Migrations管理数据库结构变更！');
        
        return Command::FAILURE;
    }
}

Symfony会自动注册该命令，执行原命令时会直接触发报错提示。

方法2：用编译器通行证彻底移除命令服务 #

通过Compiler Pass从DI容器中删除原命令服务，让命令直接“消失”：

1. 创建编译器通行证类：

// src/DependencyInjection/Compiler/RemoveUpdateSchemaCommandPass.php
namespace App\DependencyInjection\Compiler;

use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
use Symfony\Component\DependencyInjection\ContainerBuilder;

class RemoveUpdateSchemaCommandPass implements CompilerPassInterface
{
    public function process(ContainerBuilder $container): void
    {
        $serviceId = 'doctrine.orm.command.schema_update';
        if ($container->hasDefinition($serviceId)) {
            $container->removeDefinition($serviceId);
        }
        if ($container->hasAlias($serviceId)) {
            $container->removeAlias($serviceId);
        }
    }
}

2. 在Kernel中注册通行证：

// src/Kernel.php
namespace App;

use App\DependencyInjection\Compiler\RemoveUpdateSchemaCommandPass;
use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\HttpKernel\Kernel as BaseKernel;

class Kernel extends BaseKernel
{
    // ... 其他原有方法

    protected function build(ContainerBuilder $container): void
    {
        $container->addCompilerPass(new RemoveUpdateSchemaCommandPass());
    }
}

执行doctrine:schema:update时会直接提示“命令不存在”。

方法3：在services.yaml中直接覆盖服务 #

精准指定服务ID，用自定义类替换原命令服务：

# config/services.yaml
services:
    doctrine.orm.command.schema_update:
        class: App\Command\DisabledUpdateSchemaCommand
        tags:
            - { name: console.command, priority: 10 }

效果和方法1一致，适合偏好配置文件管理的场景。

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