Magento 2

Console Commands in Magento 2

In this tutorial I will give an overview of the console commands in Magento 2 and we will learn how to build a custom console command in Magento 2

Paul Mestereaga

May 21, 2019

In this tutorial I will give an overview of the console commands in Magento 2 and we will learn how to build a custom console command in Magento 2.

Magento 2 CLI

Magento has one command-line interface that performs both installation and configuration tasks. To see the full list of commands in your Magento 2 installation use the console command in your root directory:

php bin/magento list

Custom Console command

We will create a very simple command that will have a parameter as input. This will not have any eCommerce logic into it. The end goal is to have a skeleton on which you can work on. For this tutorial we will create a command that will be executed using the command:

php bin/magento mesteru:hello [name]

for example executing:

php bin/magento mesteru:hello Paul

will return “Hello Paul!”.

Lets start by creating a class called Hello in your module path VendorName\ModuleName\Console\Command

Magento 2 is using Symfony components for it’s commands so we will need to include the Symfony related classes.

You can inject using DI your own classes into the constructor, that is why for the purpose of this tutorial I included the constructor also.

The configure() method is where we set the name for the command and adding the arguments.

The execute() method is where we put all the logic to be executed by the CLI command.

Bellow is the full class implementation:

namespace Mesteru\SampleModule\Console\Command;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Magento\Framework\Console\Cli;
class Hello extends Command
const INPUT_KEY_NAME = 'name';
public function __construct(ItemFactory $itemFactory)
//here you can inject and init your needed classes 
protected function configure()
'Name to say hello'
protected function execute(InputInterface $input, OutputInterface $output)
$name = $input->getArgument(self::INPUT_KEY_NAME)
echo "Hello ".$name."!";

We will need also to add this to the commands list by using the di.xml configuration. So in your module VendorName\ModuleName\etc\di.xml have the following:

<?xml version="1.0"?>
<config xmlns:xsi="" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
<type name="Magento\Framework\Console\CommandList">
<argument name="commands" xsi:type="array">
<item name="mesteruSayHello" xsi:type="object">Mesteru\SampleModule\Console\Command\Hello</item>

This was a short overview of console commands in Magento 2. You can use this skeleton for your own logic.

You can check my previous posts about Magento 2.

Related Posts

Extend Magento 2 jQuery Widget

18 Jun 2019


Paul Mestereaga

In this short tutorial we will learn how to extend Magento 2 jQuery widget with our custom logic.

View Layer in Magento 2

7 Jun 2018


Paul Mestereaga

In this tutorial I will give an overview of the Magento 2 View Layer. We will learn how to build Blocks, Templates and Layouts.

Optimize Magento 2

Free guide to help you optimise your Magento 2 installation and improve your website speed

Get your free optimisation guide.

Enter your name and email to join my mailing list in exchange for the free download. You can opt out any time.

Can I email you?

I will use the information you provide on this form to stay in touch, send you updates, and send marketing emails about our products and services. You can unsubscribe at any time through a link in the footer of an email from me. For more information, please read the Privacy Policy.