simbio/simbio3

SIMBIO 3 PHP Framework

Simbio 3

Simbio 3 is a simple PHP framework used mainly by SLiMS (Senayan Library Management System) project, _(*1)

Installation

To install Simbio in your web project just run Composer command line inside your web project directory:, _(*2)

composer require simbio/simbio3

Or if you install manually without using Composer just put all Simbio source code inside some directory (example: simbio3) and include it at top of index.php:, _(*3)

<?php
require_once 'simbio3/Simbio.php'
require_once 'simbio3/SimbioController.php'

Autoload configuration

To make all Simbio classes loaded automatically by composer you need to edit composer.json file on your web project directory so it will looks like below:, _(*4)

{
    "require": {
        "simbio/simbio3": "*"
    },
    "autoload": {
        "psr-4": {
            "Simbio\\": "./vendor/simbio/simbio3/src/"
        }
    }
}

after you change the composer.json file you need to reload composer autoload configuration index to make it work by invoking below command in command line:, _(*5)

composer dump-autoload -o

Using Simbio router class

Create index.php on your web project root directory with below code:, _(*6)

<?php
require __DIR__.'/vendor/autoload.php';

$simbio = new Simbio\Simbio;
try {
    $simbio->route();
} catch (Exception $error) {
    exit('Error : '.$error->getMessage());
}

create minimum directory structure like below :, _(*7)

/my-web-project-dir/apps/
/my-web-project-dir/apps/modules/
/my-web-project-dir/apps/config/
/my-web-project-dir/apps/themes/

Create an application module

To create a module for your web project just follow below simple step:, _(*8)

• Create directory under /my-web-project-dir/apps/modules. For example to for module "Bibliography" the directory will be /my-web-project-dir/apps/modules/Bibliography,the first letter MUST be an uppercase
• Inside Bibliography module directory, Create file named Bibliography.php containing Bibliography class definition
• Create views and models directory inside Bibliography directory
• Inside Bibliography class you must write minimum code like below:

Bibliography controller source code:, _(*9)

<?php
class Bibliography extends \Simbio\SimbioController {
     /**
      * The parent class \Simbio\SimbioController constructor MUST be
      * also invoked in controller constructor
      *
      **/
    public function __construct($apps_config) {
        parent::__construct($apps_config);
    }

    /**
     * Default route, will be called when there is request to "http://localhost/my-web-project-dir/index.php/Bibliography
     *
     **/
    public function index() {
        echo 'Hello! this is Simbio 3 framework';
    }

    /**
     * Route for request: "http://localhost/my-web-project-dir/index.php/Bibliography/save/1"
     *
     **/
    public function save($id) {
        // SimbioController already provide $this->db PDO's object for database operation
        $stmt = $this->db->prepare("UPDATE biblio SET title=? WHERE biblio_id=?");
        $stmt->bindValue(1, 'New updated title', PDO::PARAM_STR);
        $stmt->bindValue(2, $id, PDO::PARAM_INT);
        $stmt->execute();
        // load view "update" from inside "Bibliography" module directory
        $this->loadView('update');
    }
}