In recent developments, MaplePHP has reached a significant milestone with the release of **version 2.0.0+**. This signifies the conclusion of its beta phase, marking the completion of every structural change. While substantial progress has been achieved, there is still much on the horizon. Ongoing tasks include **rigorous quality testing **and** comprehensive documentation updates**, all aimed at ensuring an even more user-friendly experience for developers.

Install the framework:

*MaplePHP comes with some pre-installed npm packages, including Stratox.js, a template engine. However, it is recommended to execute the command below to ensure you have the latest package and that every new JavaScript component is installed:*

This will install [Stratox.js](https://www.npmjs.com/package/stratox) a JavaScript template engine tailored for MaplePHP. [Read the documentation here](https://wazabii.se/stratoxjs/).

It is **not required**, and you can, for example, manually replace all content in "resources/js/main.js" and modify "package.json" with your own libraries that you are comfortable with. However, I have included it so that all the examples work.

Starting from version 2.0.0 and beyond, updating MaplePHP to the latest version is as simple as running the command below.

From you apps root directory (where the file **cli** exists) execute the following command and follow the instructions:

*Every value that comes with a default value can be skipped.*

The app is installed... You can change ever value by either enter the install command again or by opening the **.env** file and manually change it.

Access your application/site in the browser by navigating to the **"public/"** directory to observe it in action.

**Getting started in just 4 steps.** I am working on a more comprehensive guide in gitbook and will publish it as soon as possible.

1. Adding Controller

2. Add Controller to router

3. Add services to provider

5. Dispatch output

Add a controller file in the Controllers directory or you can just duplicate one of the working examples from "app/Http/Controllers/Examples/".

<?php

namespace Http\Controllers;

use MaplePHP\Http\Interfaces\ResponseInterface;

use MaplePHP\Http\Interfaces\RequestInterface;

use MaplePHP\Foundation\Http\Provider;

use Http\Controllers\BaseController;

class Pages extends BaseController

{

public function __construct(Provider $provider)

{

}

public function start(ResponseInterface $response, RequestInterface $request): ResponseInterface

{

// Your code here -->

return $response;

}

}

*More comprehensive guide will come on controllers*

Add you Controller to router **(app/Http/Routes/web.php)** by specifing a method type (GET, POST, PUT, DELETE), full namespace path to your class and specify method if you want, else maple will try to access the __invoke method.

$routes->group(function ($routes) {

// Will handle all HTTP request errors

$routes->map("*", '[/{any:.*}]', ['Http\Controllers\HttpRequestError', "handleError"]);

// Your routes here

$routes->get("/", ['Http\Controllers\Pages', "start"]);

$routes->get("/{page:contact}", ['Http\Controllers\Pages', "contact"]);

$routes->post("/{page:contact}", ['Http\Controllers\Pages', "submitContactForm"]);

}, [

// Add middlewares

MaplePHP\Foundation\Cache\Middleware\LastModified::class,

MaplePHP\Foundation\Nav\Middleware\Navigation::class,

MaplePHP\Foundation\Dom\Middleware\Meta::class

]);

*More comprehensive guide will come on router and middlewares*

Utilize the Dependency Injector for seamless and efficient connection and access to services in controllers and services in services, and so on. It effortlessly resolves dependencies, preventing the creation of duplicate instances.

1. Add them to ”configs/providers.php” services here should be accessible by the whole application.

return [

'providers' => [

'services' => [

'logger' => '\MaplePHP\Foundation\Log\StreamLogger',

'lang' => '\MaplePHP\Foundation\Http\Lang',

'responder' => '\MaplePHP\Foundation\Http\Responder',

'cookies' => '\MaplePHP\Foundation\Http\Cookie'

]

]

];

// To access a service above, e.g."logger" in your controller

// then just output:

//var_dump($this->logger());

/*

* Event handler - Example:

* Add to service provider and event handler

* Event handler will trigger every time "emergency, alert or critical" is triggered

* When they are triggered the service "MyMailService" will be triggered

* Resulting in that the log message will also be emailed

'logger' => [

"handlers" => [

'\MaplePHP\Foundation\Log\StreamLogger' => ["emergency", "alert", "critical"],

],

"events" => [

'\MyCustomService\MyMailService'

]

]

*/

2. Access services directly in your Controller and through your **constructor**.

public function __construct(Provider $provider, StreamLogger $streamLogger)

{

$this->logger = $streamLogger;

}

3. Initiate the service directly with the Container/provider.

public function __construct(Provider $provider, StreamLogger $streamLogger)

{

$provider->set("logger", StreamLogger::class);

//var_dump($this->logger()); // Access the logger

}

*What is great is that if StreamLogger has it own services and those services has their own services and so on, the dependency injector will resolve it all for you, and also without creating duplicate instances!*

*More comprehensive guide will come on provider, services and event handler*

Use built in template library or add your own either way output the content with PSR ResponseInterface.

<?php

namespace Http\Controllers;

use MaplePHP\Http\Interfaces\ResponseInterface;

use MaplePHP\Http\Interfaces\RequestInterface;

use MaplePHP\Foundation\Http\Provider;

use Http\Controllers\BaseController;

class Pages extends BaseController

{

// Use the built in template engine

public function start(ResponseInterface $response, RequestInterface $request): ResponseInterface

{

$this->view()->setPartial("ingress", [

"tagline" => "My Awesome App",

"name" => "Welcome to MaplePHP",

"content" => "Get ready to build you first application."

]);

$this->view()->setPartial("content", [

"name" => "A second breadcrumb",

"content" => "A second breadcrumb/ingress attached to the main partial."

]);

return $response;

}

// Or attach you own to the stream

public function about(ResponseInterface $response, RequestInterface $request): ResponseInterface

{

$response->getBody()->write("Hello world");

return $response;

}

}

*More comprehensive guide will come on the built in template engine and how to implement third-apart template engine*

**And thats it.. Easy right?**

There is of course **many** more functions, but with that you can start building your site or app either with MaplePHP libraries or third-party libraries that you are used to work with.

Execute the following command and follow the instructions:

The database is now installed and ready.

**IF you do not want to use table prefix, you can manually remove "MYSQL_PREFIX" or add a empty string from .env**

Execute the following command and follow the instructions. I do recommended using a SMTP but is not required:

Mail has now been installed.

In the correct order!

*Now you can use the login form (take a look at the router file app/Http/Routes/web.php) and you will see that login controller is already prepared.*