Download the PHP package devcoder-xyz/essential-core without Composer

Essential Framework Core

The Essential Framework Core is the core library of the Essential Framework, a lightweight and versatile PHP framework designed for simplifying web development tasks.

Installation

You can install the Essential Framework Core via Composer:

Usage

To use the Essential Framework Core, you can follow these steps:

1. Require the Composer Autoloader: Include Composer's autoloader in your project's entry point (e.g., index.php).

2. Create a .env File

Create a .env file in the directory defined by getProjectDir in your Kernel class. This file should contain essential environment configuration variables. At a minimum, include the following variables:

Customize the .env file further with any additional environment-specific variables your application requires.

3. Configuration Files:

Before creating the kernel and booting up the Essential Framework, it's crucial to ensure that your project's config directory contains the necessary configuration files. These files define various aspects of your application, such as services, routes, middleware, and more.

Here is a list of the essential configuration files that should be present in your config directory:

• commands.php: This file defines custom artisan commands for your application.

• framework.php: Framework-specific configuration, including options related to request handling, response generation, and other core settings.

• listeners.php: Contains event listeners and their associated event-handling logic.

• middleware.php: Lists middleware classes.

• packages.php: Defines the packages or external dependencies your application relies on.

• parameters.php: Stores parameters, often used to configure services or other parts of your application.

• routes.php: Specifies the routes and associated controllers for your application's endpoints.

• services.php: Contains definitions for services, their dependencies, and how they should be instantiated.

Ensure that these configuration files are correctly populated and tailored to your project's requirements. Proper configuration is essential for the Essential Framework to function as expected and deliver the desired behavior.

With the necessary configuration files in place, you can proceed with creating the kernel and launching your Essential Framework-powered application.

4. Create a Kernel Class: Create a Kernel class that extends BaseKernel from the Essential Framework Core. This class is the heart of your application and is responsible for configuration and bootstrapping.

You can customize the Kernel class by implementing methods like getCacheDir, getProjectDir, getLogDir, getConfigDir, and getPublicDir to define the directories used by your application.

5. Configuration Array: To configure the framework, you must define its settings using a configuration array. This array should be stored in a file named framework.php within the directory defined by public function getConfigDir(): string in the kernel.

6. Initialize the Framework: Instantiate the Kernel class and configure it to meet your application's requirements.

Essential Framework Core Configuration

The configuration file for the Essential Framework Core, named framework.php, allows you to customize critical aspects of the framework's operation. It defines several key components and functions that are used by the framework to process HTTP requests and manage dependencies.

Server Request Configuration

The server_request section is a pivotal aspect of configuring the Essential Framework Core for PSR-7 compliance. In order to use this section effectively, you must first install a PSR-7-compatible library of your choice, as the framework does not have a default PSR-7 implementation.

Once you've installed a PSR-7 library, you can define a custom function within the server_request section to specify how the framework should create instances of the ServerRequestInterface. This customization allows you to tailor the request instantiation process to align with the PSR-7 specification and your application's specific requirements.

Here's an example of how you might configure the server_request section to use the Laminas Diactoros library for request instantiation:

Response Factory Configuration

The response_factory section is a critical component responsible for generating HTTP responses within the Essential Framework Core, and it operates in alignment with the PSR-17 standard (HTTP Factories). However, to use this section effectively, it's essential to install a PSR-17-compatible library of your choice since the framework does not include a default PSR-17 implementation.

Once you've installed a PSR-17 library, you can define a custom function within the response_factory section to specify how the framework should create instances of the ResponseFactoryInterface. This customization allows you to tailor the response generation process to comply with the PSR-17 specification and your application's specific needs.

Here's an example of how you might configure the response_factory section to use the Laminas Diactoros library for response instantiation:

Container Configuration

The container section is integral to managing dependencies and services within the Essential Framework Core. To use this section effectively, it's essential to have a PSR-11 compatible container implementation installed, as the framework does not provide a default PSR-11 container.

For example, you can configure the container section to use the \DevCoder\DependencyInjection\Container provided by the DevCoder library for dependency injection. Here's an example of how you might set it up:

Custom Environments

The custom_environments section is an array that allows you to define custom application environments beyond the standard 'development' and 'production' environments. You can use these custom environments to handle different aspects of your application based on specific requirements.