drewm / slim-commander
A very simple structure for running CLI commands as part of your Slim Framework application
Requires
- php: >=5.5.0
- slim/slim: ^3.1
This package is auto-updated.
Last update: 2024-10-24 04:13:23 UTC
README
A very simple structure for running CLI commands as part of your Slim Framework application.
This is not a console tool. It's just a parallel to the HTTP entry point into your application, enabling you to do things like create create scripts to be run as cronjobs or set up basic queue listeners.
Usage
Taking the structure of Slim-Skeleton as an example, your public/index.php
does this:
require __DIR__ . '/../vendor/autoload.php'; session_start(); // Instantiate the app $settings = require __DIR__ . '/../src/settings.php'; $app = new \Slim\App($settings); // Set up dependencies require __DIR__ . '/../src/dependencies.php'; // Register middleware require __DIR__ . '/../src/middleware.php'; // Register routes require __DIR__ . '/../src/routes.php'; // Run app $app->run();
You need to create a new PHP script, similar to this, to serve as the entry point for your commands.
It should be outside the public
folder. Perhaps src/cli.php
.
require __DIR__ . '/../vendor/autoload.php'; // Instantiate the app $settings = require __DIR__ . '/settings.php'; $app = new \DrewM\SlimCommander\App($settings); // Set up dependencies require __DIR__ . '/dependencies.php'; // Register commands instead of routes require __DIR__ . '/commands.php'; // Run app $app->run($argv);
Instead of routes, you define commands in e.g. src/commands.php
.
$app->command('HelloWorld', 'HelloWorld:greet', [ 'name', ]);
Arguments are:
- Name of the command
- The callback, defined in the same way as a regular Slim route callback
- An array of expected argument names
In the above example, the first argument will be passed to the callback as name
Your callback gets the container passed to its constructor:
class HelloWorld { private $container; public function __construct($container) { $this->container = $container; } public function greet($args) { echo "Hello " . $args['name']; } }
Add it to your container, just as you would normally:
$container['HelloWorld'] = function ($container) { return new \App\Commands\HelloWorld($container); };
And then you'd execute it with php src/cli.php HelloWorld Fred