bandama/framework

Bandama is a microframework for PHP application

1.2.3 2017-07-06 23:44 UTC

Requires

• php: >=5.5

Requires (Dev)

• php: >=5.5
• kahlan/kahlan: ^3.1

MIT

• Jean-François YOBOUE

README

Bandama is a PHP micro-framework to create Web Applications and Web APIs

Installation

It's recommended that you use Composer to install Bandama Framework.

$ composer require bandama/framework "1.2.*"

This will install Bandama Framework and all required dependencies. Bandama Framework requires PHP 5.5 or newer.

You can also install Bandama Framework by downloading it

Usage

There is an index.php file in root directory with the following contents:

<?php

require(__DIR__.'/vendor/autoload.php');


$app = Bandama\App::getInstance(null, Bandama\App::APP_MODE_DEV);
$router = $app->get('router');

$router->get('/', function() {
    echo "<pre>Bandama Framework</pre>";
});

$router->get('/hello/:name', function($name) {
    echo "<pre> Hello, $name";
});

$app->run();

You may quickly test this using the built-in PHP server:

$ php -S localhost:8008

Going to http://localhost:8008 will now display "Bandama Framework".

Going to http://localhost:8008/hello/world will now display "Hello, world".

Components

• Router
• Session
• PDO Session Handler
• Cookie
• Controller
• Dependency Injection Container
• Database Connection
• Query Builder
• Translator

Tests

Unit tests use Kahlan. To execute the tests, type

$ php vendor/bin/kahlan --reporter=verbose --coverage=4

Change log

• 1.2.3
  • Allow registration of many types of flash messages
• 1.2.2
  • Bug fixed when deleting base URI
• 1.2.1
  • Adding registerComponents method to application bootstrap methods (setup method)
• 1.2.0
  • Adding translator component
  • Using Kahlan for unit tests
• 1.1.2
  • Making getInstance method of App class inheritable
  • Adding test index.php in root directory
  • Remove index.php entry in .gitignore file
• 1.1.1
  • Removing user_id column in sessions table
• 1.1.0
  • Moving application setup method of App class from constructor to getInstance method
• 1.0.10
  • Improvement of App setup method
• 1.0.9
  • Bug fixed in App class
• 1.0.8
  • Adding base URI Management in App class
• 1.0.7
  • Bug fixed in render method of Controller class
• 1.0.6
  • Adding static method newInstance to container class
  • Adding addService method to App class
• 1.0.5
  • Adding PDO Session Handler for relationnal database session management

Credits

• Jean-François YOBOUE

License

The Bandama Framework is licensed under the MIT license. See License File for more information.