PHP Luminova: Nova-Kit Command Patterns and Integrations

The Luminova framework includes NovaKit, a Command Line Utility Tool designed to simplify application development. This tool allows for the extension and implementation of custom command-line logic based on your application's needs, through the Base Command Controller Class and Luminova\Base\BaseConsole class. By extending Luminova\Base\BaseCommand, you can create command-line tools that operate similarly to HTTP controllers and request methods, supporting command routing using PHP Route Attributes as well as Method Based Routing.

What Is NovaKit?

NovaKit handle the command execution and output formatting offering various functionalities, including:

• Generating boilerplate code.
• Creating scaffolds and templates.
• Managing environment variables.
• Handling database operations like migration, versioning and seeding.
• Managing application logs.
• Executing cron tasks on production environment.
• Running a PHP development server.
• And more.

Listing Available NovaKit Commands

To display the list of available NovaKit commands, open your command line tool, navigate to your project directory where the novakit file is located, and run:

php novakit list

Novakit Help Command

To show general help information related to novakit commands.

Print novakit help information.

php novakit --help

Print help all novakit commands help information.

php novakit --help --all

To print help information related to a specific novakit command.

php novakit log --help

Default Command Flags

Use these flags with commands to modify output formatting.

• --no-header: Omits the header from the output.

  Copy

  php novakit <command> --no-header

• --no-color: Disables colored output.

  Copy

  php novakit <command> --no-color

• --no-ansi: Disables ANSI formatting for terminals that don't support it.

  Copy

  php novakit <command> --no-ansi

Basic NovaKit Generators Commands

The generator commands allow you to easily generate a skeleton for a controller class, utils class, or a view file.

Utils Class

To create a utility class for your application use the below example command.The class will be saved in /app/Utils/

php novakit create:class "myClass" --extend "baseClassName" --implement "myClassInterface"

Model Class

To create a database model class for your application use the below example command.The class will be saved in /app/Models/

php novakit create:model "myModel" 

Controllers

To create a new controller class for your application use the below example command.The class will be saved in /app/Controllers/Http/ or /app/Modules/<module>/Controllers/Http/ for HMVC application.

php novakit create:controller 'PayStackController'  --type 'view'

You can pass the type of API to extend \Luminova\Base\BaseController or view to extend \Luminova\Base\BaseViewController.

For command controller class extend and implement will ignore, use flag --type "command"

View File

To create a utility class for your application use the below example command.The class will be saved in /resources/Views/ or /app/Modules/<module>/Views/ for HMVC application.

php novakit create:view "blog" 

To create a view file in a subdirectory in /resources/Views/ folder, use flag --dir "mySubDir"

Routing Context

To install a new routing context use the below example command.

php novakit context "test"'

The above command will create a file in /routes/ directory and update your /public/index.php with a new context.

To disable adding an error handler in index.php use flag --no-error

Note: If the error handler is not disabled, you need to manually create the method name in your View errors class in /app/Controllers/Errors/ViewErrors.php.

Sitemap

To generate your website sitemap use the below command.

php novakit generate:sitemap

To configure the sitemap domain and ignore list, it can be done here /app/Config/Sitemap.php.

Application Cryptic Key

To generate your application encryption and decryption key use the below command.

php novakit generate:key

If you wish to generate without saving the key to env file, use flag --no-save.

Add/Update Environment Variables

To add new or update value to your env file use the below command.

php novakit env:add --key='my_new_key' --value='my key value'

If you wish to generate without saving the key to env file, use flag --no-save.

Remove Environment Variable

To remove key from your env file use the below command.

php novakit env:remove --key='my_old_key'

Build Exportable Project Files

To package your application for publishing, use the below command to archive the project files required for production.

php novakit build:project --type zip

Managing Application Log Files

To manage your application log files, you will need to specify the log level you want to view or manage.In this example we will be using debug.

Display the 5 Most Recent Entries

To view the 5 most recent entries in the debug log:

php novakit log --level=debug

Display Log Entries Using offset and limit

To display debug log entries starting from line 5 and showing only the next 20 entries:

php novakit log --level=debug --start=5 --end=20

Clear the Entire Log File

To clear all entries from the debug log file:

php novakit log --level=debug --clear

Building Command Line Tools

Creating command-line tools in Luminova is straightforward, thanks to its intuitive routing system, which resembles HTTP routing. This familiarity makes it easy to apply known logic to your CLI commands.

Command Controllers

To create a new command controller in Luminova:

1. Create Your Command Controller: Place your command controller classes in the /app/Controllers/ directory, alongside your HTTP controller classes. Ensure these classes extend Luminova\Base\BaseCommand.
2. Define Your Method: Use either PHP Attributes or code-based routing with the Router class methods for command implementations.
3. Optional Help Display: Implement a command help display with styling and formatting as desired, or use the default display implementation.

Command Execution Pattern:

To execute a custom controller command, open your command line tool, navigate to your application's public directory with cd path/to/your-project/public, and run the command following this pattern:

php index.php <group-name> <command-name> <arguments>

Print help information related to a command controller group.

php index.php <group-name> --help

The group-name should be immediately after php index.php, followed by the command-name and any parameters. Arguments can be passed in any order after the command group name.