Download the PHP package dotkernel/dot-console without Composer

dot-console

DotKernel component to build console applications based on laminas-console

NOTE

laminas-console is abandoned and will receive no further development!

We recommend using dotkernel/dot-cli.

Requirements

• PHP >= 7.4
• laminas/laminas-servicemanager >= 3.4,
• laminas/laminas-console >= 2.8

Installation

Run the following command in your project root directory

Next, register the package's ConfigProvider to your application config. If can also manually register the package's dependencies in your container. There is only one dependency that need to be registered Dot\Console\Factory\ApplicationFactory that should be used to create an Laminas\Console\Application object used to bootstrap the app.

Configuration and Usage

You should create a bootstrap file in your project, similar to index.php, that will be called from the command line to start console commands. We advise you to create a bin folder in your project's root folder. Here you can create a console.php file with the following content.

This assumes you are using one of our web starter applications or a Mezzio similarly structured application. Next you can go to the command line and call console commands

You can try some of the provided out-of-the box commands

Creating commands

dot-console is mainly a wrapper around laminas-console. You should check their full documentation before. Why a wrapper?

• it allows us to extend the original package if we need
• we can simplify some things

The first thing this package offers, is the Dot\Console\Application factory that creates a package using the configuration array provided at dot_console key. An console application needs a name, version, route configuration, console instance and dispatcher. You can provide a configuration file for the console application in the following format

The second thing is an abstract class that you commands should extend. This class forces the __invoke method with the proper parameter definition that defines console commands. Commands must be invokable classes with the following signature:

Command classes are pulled from the container, so you might inject your commands with dependencies.

'Hello World!' command example

Create HelloCommand class

Next, register this class in your container as a dependency.

Add command to config

Update the console configuration to include this command

Add custom parameters to config

Please note that the content of:

• description is displayed when the command is executed
• short_description is displayed when the list of available commands is executed or getting help for a specific command

Testing command

In command line, go to your project's root directory and type the following command:

For a complete documentation you can follow laminas-console. Anything there related to commands are applicable to this package too.

License

MIT