在 Symfony 2.7.10 中创建自定义命令需继承 Command 类,重写 configure() 和 execute() 方法,命名格式为 app:your-task,推荐通过 services.yml 显式注册并打 console.command 标签,依赖建议构造函数注入,运行前清缓存并用 php app/console app:send-newsletter 调用。

在 Symfony 2.7.10 中创建自定义命令行工具,核心是继承 Symfony\Component\Console\Command\Command 类,并在容器中注册为服务(或通过 Command 目录自动发现)。关键在于正确配置命名、依赖注入和控制台交互逻辑。
定义命令类并继承 Command
在 src/AppBundle/Command/ 下新建 PHP 文件(如 SendNewsletterCommand.php):
- 必须继承
Symfony\Component\Console\Command\Command - 重写
configure()方法设置命令名、描述和参数/选项 - 重写
execute()方法编写实际逻辑,接收InputInterface和OutputInterface实例 - 命令名格式建议为
app:your-task(冒号分隔,避免冲突)
注册为服务(推荐方式)
Symfony 2.7 默认启用命令自动发现,但显式注册服务更可控,尤其需注入其他服务时。在 src/AppBundle/Resources/config/services.yml 中添加:
services:
app.command.send_newsletter:
class: AppBundle\Command\SendNewsletterCommand
tags:
- { name: console.command }
# 若需注入服务,例如邮件发送器:
# arguments: ['@mailer']
确保该文件被主配置加载(app/config/config.yml 中已包含 AppBundle 的 services.yml)。
在 execute() 中安全使用依赖和服务
命令类默认不自动注入服务。若需访问 Doctrine、Mailer 或其他服务,有以下两种方式:
-
构造函数注入:在服务定义中通过
arguments传入,同时在类中声明构造函数参数并赋值给属性 -
容器注入:在
execute()内通过$this->getContainer()获取(仅限继承ContainerAwareCommand,但 Symfony 2.7 中已不推荐,建议用构造注入) - 注意:不要在
configure()中访问容器或服务,该方法在命令初始化阶段调用,容器可能未就绪
测试与运行命令
执行前先清除缓存(开发环境):
php app/console cache:clear --env=dev
然后运行你的命令:
php app/console app:send-newsletter --limit=10
若命令未出现在 php app/console list 中,请检查:
- 类文件路径与命名空间是否匹配
- 服务是否正确定义且标签为 console.command
- 是否存在语法错误导致类无法加载(可运行 php app/console debug:container --tag=console.command 查看已注册命令)


















