clagiordano/weblibs-mvc

weblibs-mvc is an simple and lightweight php routing component.

v1.1.2 2018-07-19 09:21 UTC

README

BuildStatus License

weblibs-mvc

weblibs-mvc is an simple and lightweight php routing component. This component can have a RESTful support simply adding an .htaccess file, see below for more details.

SensioLabsInsight

Based on http://php-html.net/tutorials/model-view-controller-in-php/
Based on http://phpro.org/tutorials/Model-View-Controller-MVC.html#9

Description of the main components

Application

The application class is the main component wich handle and relates components between them.

Controller

The Controller is the C in MVC. The base controller is a simple abstract class that defines the structure of all controllers. By including the registry here, the registry is available to all class that extend from the base controller. An index() method has also been included in the base controller which means all controller classes that extend from it must have an index() method themselves.

Registry

The registry is an object where site wide variables can be stored without the use of globals. By passing the registry object to the controllers that need them, we avoid pollution of the global namespace and render our variables safe. We need to be able to set registry variables and to get them.

Routing

The router class is responsible for loading up the correct controller. It does nothing else. The value of the controller comes from the URL.

Template

The templates themselves are basically HTML files with a little PHP embedded. Do not let the separation Nazi's try to tell you that you need to have full separation of HTML and PHP. Remember, PHP is an embeddable scripting language. This is the sort of task it is designed for and makes an efficient templating language. The template files belong in the views directory.

Installation

The recommended way to install weblibs-mvc is through Composer.

composer require clagiordano/weblibs-mvc

Adding RESTful support to destination project

Simply add into yours project root a file named .htaccess
(webserver must be allow override) which contains the following lines:

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?rt=$1 [L,QSA]

this simple steps allow your application make RESTful calls like:

http://www.example.com/clients/68563
http://www.example.com/access/login
http://www.example.com/chart/
http://www.example.com/products/6574

Usage

/**
 * Composer autoload
 */
require_once __DIR__ . '/vendor/autoload.php';

/**
 * Import required classes
 */
use clagiordano\weblibs\mvc\Application;
use clagiordano\weblibs\mvc\Registry;
use clagiordano\weblibs\mvc\Router;
use clagiordano\weblibs\mvc\Template;

/**
 * Init base application
 * @var Application $application
 */
$application = new Application();

/**
 * Router setup
 */
$application->setRouter(
    new Router($application)
);

/**
 * set the path to the controllers directory
 */
$application->getRouter()->setControllersPath(
    __DIR__ . '/controllers'
);

/**
 * Template setup
 */
$application->setTemplate(
    new Template($application)
);

/**
 * load the controller / run the application
 */
$application->getRouter()->loader();

Legal

Copyright (C) Claudio Giordano claudio.giordano@autistici.org