在 Symfony 项目中创建自定义命令需满足路径、命名与方法签名约束：一、用 Maker Bundle 自动生成；二、手动创建并继承 Command、重写 configure() 和 execute()；三、确保注册（自动发现或 services.yaml 配置）；四、正确定义并读取参数与选项；五、通过依赖注入获取服务，用 $output 输出，返回整数状态码。
如果您希望在 Symfony 项目中添加可直接通过 php bin/console 调用的自定义命令，则需满足类路径、命名规范与方法签名等硬性约束。以下是创建自定义命令的具体操作路径：
一、使用 Maker Bundle 自动生成命令类
该方式适用于已安装 symfony/maker-bundle 的 Symfony 5.4+ 或 6.x/7.x 项目，能自动完成文件创建、目录放置与基础结构填充。
1、执行命令生成新命令类：php bin/console make:command app:backup:users
2、输入命令类名（如 BackupUsersCommand），回车确认
3、检查生成文件是否位于 src/Command/BackupUsersCommand.php，且类名以 Command 结尾
二、手动创建命令类并配置基础结构
当 Maker Bundle 不可用或需完全控制实现细节时，可手动创建类文件，必须严格继承 Symfony\Component\Console\Command\Command 并重写 configure() 和 execute() 方法。
1、在 src/Command/ 目录下新建 PHP 文件，例如 SendNewsletterCommand.php
2、声明命名空间为 App\Command，并继承 Command
3、在 configure() 中调用 $this->setName('app:send-newsletter') 和 $this->setDescription('Send newsletter to active subscribers')
4、确保 execute() 方法签名完整：protected function execute(InputInterface $input, OutputInterface $output): int
三、正确注册命令类（适配不同 Symfony 版本）
Symfony 5.4+ 默认启用自动发现机制，但前提是类文件位置与命名合规；旧版本需显式配置服务加载规则，否则命令不会出现在 php bin/console 列表中。
1、确认 config/services.yaml 中包含以下块（Symfony 4.4–5.3 必须）：App\Command\: resource: '../src/Command/*' autoconfigure: true
2、若使用 Symfony 3.4，需让命令类继承 ContainerAwareCommand，并在 execute() 中通过 $this->getContainer()->get('doctrine') 获取服务
3、运行 php bin/console 验证命令是否列出；若未出现，检查文件路径是否为 src/Command/xxxCommand.php，类名是否含 Command 后缀
四、定义参数与选项并安全读取
命令需明确声明其接受的参数（位置式、必填/可选）和选项（--前缀、可缩写），否则运行时将抛出 InvalidArgumentException 异常。
1、在 configure() 中添加参数：$this->addArgument('batch-size', InputArgument::OPTIONAL, 'Number of users per batch', 100)
2、添加布尔选项：$this->addOption('dry-run', 'd', InputOption::VALUE_NONE, 'Output what would be sent without sending')
3、在 execute() 中读取：$batchSize = $input->getArgument('batch-size'); 与 $isDryRun = $input->getOption('dry-run');
4、禁止直接使用 $_SERVER 或全局变量获取输入，必须经由 $input 实例
五、在 execute() 中注入服务并执行业务逻辑
命令执行体不可直接 new 实例，应通过依赖注入或容器获取服务；尤其涉及 Doctrine、邮件、密码哈希等组件时，必须保障对象生命周期与容器一致。
1、若使用 Symfony 4.4+，可在 execute() 方法签名中类型提示所需服务：protected function execute(InputInterface $input, OutputInterface $output, EntityManagerInterface $em, MailerInterface $mailer): int
2、若使用 Symfony 3.4 或禁用自动注入，改用容器获取：$em = $this->getContainer()->get('doctrine.orm.entity_manager');
3、所有终端输出必须使用 $output->writeln()，禁止使用 echo 或 print_r
4、execute() 必须返回整数：return 0; 表示成功，return 1; 表示失败
