genesis / micro-framework
Simple classes tied with a convention.
Requires
- genesis/method-persister: ~1.0
- genesis/persistence: ~2.0
This package is not auto-updated.
Last update: 2024-11-05 13:44:04 UTC
README
Bunch of classes with a bit of convention to get your started.
Setup
To get boiler plate code for a quick start, run the following commands (bash/cli acquainted users):
composer require genesis/micro-framework make -f vendor/genesis/micro-framework/Makefile build
At the end of the output you'll receive a snippet for the composer.json file, add and now start local server:
make serve
open localhost:8000
in your browser and you should see hello world!
.
If the above steps do not work, run make -f vendor/genesis/micro-framework/Makefile cleanup
and proceed step by step:
Place the following code in your index file. Assuming that:
- the index file is in the public folder.
- you have an autoloading rule in composer.json file that points the namespace App\Controller to your controllers folder.
<?php use Genesis\Microframework\Service\Config; use Genesis\Microframework\Service\Router; use Genesis\Microframework\Service\Request; use App\Controller; require __DIR__ . '/../vendor/autoload.php'; $router = new Router($_GET, $_SERVER); $router->registerRoutes( [ '/' => Controller\Index::class, ] ); Config::set('view_path', __DIR__ . '/../src/View/'); $router->dispatchRequest(new Request());
The dispatcher will call upon the index() method in each controller only.
Database
To add database support, add config for database like so in the above file before the dispatchRequest()
call:
Config::set('db_params', [ 'dbengine' => 'mysql', 'host' => 'localhost', 'port' => 3306, 'dbname' => 'myDB', 'username' => 'root', 'password' => 'password' ]);
And call upon the getMapperService()
method to persist your models. For more information follow guide here https://github.com/forceedge01/genesis-persistence.
View
Call a view in your controller like so:
# src/Controller/Index <?php namespace App\Controller; use Genesis\MicroFramework\Controller\BaseController; /** * Index class. */ class Index extends BaseController { public function index() { echo $this->render('index.php', [ 'name' => 'Abdul' ]); } }
Expect to have a view file src/View/index.php
which renders the variable name
. There is no engine supplied but can be added.