Build beautiful console applications with CakePHP

4.2.8 2021-05-24 17:26 UTC


Total Downloads License

CakePHP Console Library

This library provides a framework for building command line applications from a set of commands. It provides abstractions for defining option and argument parsers, and dispatching commands.


You can install it from Composer. In your project:

composer require cakephp/console

Getting Started

To start, define an entry point script and Application class which defines bootstrap logic, and binds your commands. Lets put our entrypoint script in bin/tool.php:

#!/usr/bin/php -q
// Check platform requirements
require dirname(__DIR__) . '/vendor/autoload.php';

use App\Application;
use Cake\Console\CommandRunner;

// Build the runner with an application and root executable name.
$runner = new CommandRunner(new Application(), 'tool');

For our Application class we can start with:

namespace App;

use App\Command\HelloCommand;
use Cake\Core\ConsoleApplicationInterface;
use Cake\Console\CommandCollection;

class Application implements ConsoleApplicationInterface
     * Load all the application configuration and bootstrap logic.
     * @return void
    public function bootstrap(): void
        // Load configuration here. This is the first
        // method Cake\Console\CommandRunner will call on your application.

     * Define the console commands for an application.
     * @param \Cake\Console\CommandCollection $commands The CommandCollection to add commands into.
     * @return \Cake\Console\CommandCollection The updated collection.
    public function console(CommandCollection $commands): CommandCollection
        $commands->add('hello', HelloCommand::class);

        return $commands;

Next we'll build a very simple HelloCommand:

namespace App\Command;

use Cake\Console\Arguments;
use Cake\Console\BaseCommand;
use Cake\Console\ConsoleIo;
use Cake\Console\ConsoleOptionParser;

class HelloCommand extends BaseCommand
    protected function buildOptionParser(ConsoleOptionParser $parser): ConsoleOptionParser
            ->addArgument('name', [
                'required' => true,
                'help' => 'The name to say hello to',
            ->addOption('color', [
                'choices' => ['none', 'green'],
                'default' => 'none',
                'help' => 'The color to use.'

        return $parser;

    public function execute(Arguments $args, ConsoleIo $io): ?int
        $color = $args->getOption('color');
        if ($color === 'none') {
            $io->out("Hello {$args->getArgument('name')}");
        } elseif ($color == 'green') {
            $io->out("<success>Hello {$args->getArgument('name')}</success>");

        return static::CODE_SUCCESS;

Next we can run our command with php bin/tool.php hello Syd. To learn more about the various features we've used in this example read the docs: