Documentation

Kevion Base is the foundational module for all Kevion Magento 2 extensions. It provides shared infrastructure including logging, import engine, scheduler, notifications, and CLI commands.

Requirements

Installation

Install via Composer:

composer require kevion/module-base

Enable the module:

php bin/magento module:enable Kevion_Base

php bin/magento setup:upgrade

php bin/magento cache:clean

Verifying Installation

Run the following CLI command to confirm the module is active:

php bin/magento kevion:modules:list

You should see `Kevion_Base` listed with version 1.0.0.

Kevion Base provides a unified logging system built on Monolog. All Kevion extensions write to the same log file (`var/log/kevion.log`) for easier debugging.

Configuration

Configure logging via `app/code/Kevion/Base/etc/config.xml` or the Magento admin panel at **Stores → Configuration → Kevion → Base → Logging**.

### Options

Usage in Your Code

use Kevion\Base\Model\Logger;

class YourClass

{

public function __construct(

private Logger $logger

) {}

public function doSomething(): void

{

$this->logger->info('Processing started');

$this->logger->error('Something went wrong', ['exception' => $e]);

}

}

The import engine provides a framework for batch-processing CSV, XML, and JSON data with row validation, error reporting, and progress tracking.

Architecture

Creating an Importer

use Kevion\Base\Model\Import\AbstractImporter;

class ProductImporter extends AbstractImporter

{

protected function validateRow(array $row): array

{

$errors = [];

if (empty($row['sku'])) {

$errors[] = 'SKU is required';

}

return $errors;

}

protected function processRow(array $row): void

{

// Process each validated row

}

}

Running an Import

php bin/magento kevion:import:run Vendor_Module \

--file=/path/to/data.csv \

--format=csv \

--batch=100

Database-backed cron scheduler that allows extensions to register recurring tasks without editing Magento's `crontab.xml`.

Registering a Task

use Kevion\Base\Model\Scheduler\Task;

$task = $scheduler->register(

'vendor_module_task',

'0 */2 * * *', // every 2 hours

VendorModule\Cron\Task::class

);

CLI Management

# List all scheduled tasks

php bin/magento kevion:scheduler:list

# Run a specific task manually

php bin/magento kevion:scheduler:run vendor_module_task

Kevion Base provides the following CLI commands: