slight/slight

slight

Simple php routing class for quick bootstrapping. Slight is just a small wrapper class which helps you easily separate logic from markup, its minimal just a single class, and very fast. Slight uses Twig for templating which is awesome., _(*1)

Installation

Via composer, _(*2)

composer require slight/slight

Usage

First create an .htaccess file where your index.php is and add this, _(*3)

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [QSA,L]

Instantiate slight

get('/', function() {
  return 'Hi Home';
});

//Run slight
$app->run();
```
###Basic routing
```php
get('/', function() {
  return 'Hi Home';
});

$app->get('/admin/', function() {
  return 'Hi Admin';
});

//Run slight
$app->run();
```
###Parameters
```php
get('/admin/:username/', function($username) {
  return 'Hello '.$username;
});

$app->get('/admin/:firstname/:lastname/', function($firstname, $lastname) {
  return 'Welcome '.$firstname.' '.$lastname;
});

//Run slight
$app->run();
```

###Redirects
```php
get('/admin', function() use ($app) {
  $app->redirect('/admin/login/');
});

$app->get('/admin/login', function() use ($app) {
  return 'Login page';
});

//Run slight
$app->run();
```

###Rendering output to file
All variables passed to the render function will be mapped
to a $display variable which can be used to output content.
```php
get('/foo', function() {
  return $app->render('foo.php', array(
    'foo' => 'Bar'
  ));
});

$app->run();
```
####In foo.php
```php
//Will output Bar

Using Twig to render output

When you install slight you will notice that Twig is also installed as a dependency. That is because Slight can also work closely with Twig., _(*4)

<?php

//Require slight
require "vendor/autoload.php";

//Configure the templates folder
$app = new SlightApp(array(
  'templates' => 'views'
));

$app->get('/', function() use ($app) {
  return $app->render('foo.html', array(
    'foo' => array(
      'name' => 'Bar',
      'username' => 'baz'
    )
  ));
});

//Run slight
$app->run();

In foo.html now using Twig

{{ foo.name }} {{ foo.username }}, (*5)

Using singleton to connect to a database

<?php

//Require slight
require "vendor/autoload.php";

//Instantiate slight
$app = new SlightApp();

//Connect to mongodb using singleton
$app->singleton("database", function() use ($app) {
  //this will create $database property in slight
  //which will map to a testDatabase in MongoDB
  //this property can then be accessible using $app->database
  //Similar connections can be made to a MySQL database too.
  $connection = new MongoClient();
  return $connection->testDatabase;
});

//Home route
$app->get('/', function() use ($app) {
  //Find users from database, using property created from singleton.
  $users = $app->database->Users->find();
  //Render them
  return $app->render('users.html', array(
    "users" => $users
  ));
});

//Run slight
$app->run();