MaplePHP

MaplePHP is a layered structure PHP framework that has been meticulously crafted to provide developers with an intuitive, user-friendly experience that doesn't compromise on performance or scalability. By leveraging a modular architecture with full PSR support, the framework allows for easy customization and flexibility, enabling developers to pick and choose the specific components they need to build their applications. Overall, the PHP Fuse framework is an excellent choice for developers looking to build high-quality web applications quickly and efficiently.

MaplePHP's commitment to agnosticism ensures that it remains free of dependencies, allowing developers the flexibility to choose dependencies based on their specific project needs rather than being dictated by the framework. The framework's streamlined approach guarantees it avoids bloat by incorporating only essential libraries, each serving a distinct purpose without redundancy.

Moreover, MaplePHP sets itself apart through its seamless communication between the backend and the frontend, facilitated by Stratoxjs—a purpose-built tool tailored specifically for Maple. This integration enhances the framework's unique capabilities, fostering efficient and effective development of high-quality web applications.

Much more to be done

The MaplePHP framework is still a work in progress, with over 800 points on my checklist that need attention—no exaggeration. I am tho eager to highlight its noteworthy features. However, I recommend refraining from using the framework in live projects at the moment. It would be prudent to wait for version 1.1.0, when I have check off all the points and can offer a comprehensive documentation, ensuring a more user firendly user experience.

Installation

The primary installation.

composer create-project maplephp/maplephp myApp

Git Installation

If you want to access all the git repositories and contribute then choose this installation.

1. Clone the repo with all submodules

git clone --recurse-submodules -j8 git@github.com:MaplePHP/MaplePHP.git myApp

As of the git version 2.8 the -j8 can be used as an performance optimizer and will fetch submodules at a time in parallel

2. Install dependencies

composer install

3. Remove MaplePHP directory in vendor

All MaplePHP libraries now reside in the "app/Libraries/" directory. However, it's important to note that MaplePHP also exist in the vendor directory from the composer install and will take precedence. Therefore, if you wish to contribute, please ensure that you remove the MaplePHP directory from the vendor directory (vendor/maplephp/).

rm -rf vendor/maplephp

If you are on a unix system you can execute above.

Install the app

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

php cli config install --type=app

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.

Install database

Execute the following command and follow the instructions:

php cli config install --type=mysql

The database is now installed and ready.

Install mail

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

php cli config install --type=mail

Mail has now been installed.

Install Auth and login form

Requires at least MaplePHP framework 1.0.4

Install the database:

In the correct order!

php cli migrate create --table=organizations

php cli migrate create --table=users

php cli migrate create --table=login

php cli migrate create --table=usersToken

Add organization

php cli database insertOrg

Add user

php cli database insertUser

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.

Library guides

The guide is not complete. There is much more to come.

• Cache
• Container
• DTO
• Form
• Handler
• Http
• Log
• Output
• Query
• Roles
• Validate
• Clock (Guide not complete)
• Cookies (Guide not complete)
• Auth (Guide not complete)

More functions

• Pen-tested
• Quality code tested
• Dependency injector
• Will have full PSR support
• Service provider
• Multiple languages
• Built in protection againt XSS, CSRF, session injection, MySql injection
• Emitter, CSP, Strict transport-security
• Seamless communication between frontend and backend
• Lightweight frontend code yet powerfull.

Preview

Guide will come

namespace Http\Controllers;

use MaplePHP\Http\Interfaces\ResponseInterface;
use MaplePHP\Http\Interfaces\RequestInterface;
use MaplePHP\Foundation\Http\Provider;
use Http\Controllers\BaseController;

class YourController extends BaseController  {

    function __construct(Provider $provider) {
    }

    function about(ResponseInterface $response, RequestInterface $request) {

        // Meta (DOM)
        $this->head()->getElement("title")->setValue("About us");
        $this->head()->getElement("description")->attr("content", "Lorem ipum dolor");

        // Template
        $this->view()->setPartial("breadcrumb", [
            "tagline" => getenv("APP_NAME"),
            "name" => "Welcome to MaplePHP",
            "content" => "Get ready to build you first application."
        ]);
        
        //$this->local("auth")->get("wrong-credentials", "Wrong credentials"); // Static translate
        //$this->lang()
        //$this->cookies()
        //$this->mail()
        //$this->responder()
        //...

        return $response;
    }

}