Run command line tasks for Slim PHP

3.2.0 2023-03-11 16:27 UTC

This package is auto-updated.

Last update: 2024-05-19 00:52:12 UTC


Create and run command line tasks for the Slim PHP micro-framework



composer require adrianfalleiro/slim-cli-runner ^3.1

For Slim 3 support install version 2.6 or lower

Register Middleware

Register the middleware in middleware.php

$app->add(new adrianfalleiro\SlimCliRunner\CliRunner::class);

Define, Register and run your tasks

Task definition

Tasks are classes which extend CliAction and have a public command() method.

You can inject dependencies through the class constructor.

use Psr\Http\Message\ResponseInterface as Response;
use adrianfalleiro\SlimCliRunner\CliAction;

use Psr\Log\LoggerInterface;

class ExampleCliAction extends CliAction
    public function __construct(LoggerInterface $logger)
        $this->logger = $logger;

    protected function action(): Response
        $arg0 = $this->resolveArg(0);
        $this->logToConsole("arg 0 is {$arg0}");

        return $this->respond();

Tasks registration

Add a new key in your settings.php definitions file called commands and list your tasks. To define a default task (For use when no command name is provided) add a new task with __default as key

return function (ContainerBuilder $containerBuilder) {
    // Global Settings Object
        'settings' => [
        'commands' => [
            '__default' => \Namespace\To\Task::class
            'SampleTask' => \Namespace\To\Task::class

Run Tasks

There are multiple ways of doing this:
Directly via command line:

php public/index.php SampleTask arg1 arg2 arg3

Via composer:

    "config": {
        "process-timeout" : 0
    "scripts": {
        "cli": "php public/index.php"

The command

composer cli SampleTask argument1 argument2 argument3


An example project can be found in the examples/ folder