Kecik Framework

> PayPal:  > > Rekening Mandiri: 113-000-6944-858, Atas Nama: Dony Wahyu Isprananda

Is a framework with a very simple file system, so this is not a complex framework, but you can build and develop this framework to be a complex framework. This Framework support simple MVC where you still have to customize some code for get complex MVC, for Model just generate SQL Query for INSERT, UPDATE and DELETE only, so for code execution that SQL Query please make your self freely as you want or using whichever database libaries. This Framework also support Composer, so as to facilitate you for adding a library from composer.

Name 	: Framework Kecik
Author  : Dony Wahyu Isp
Version : 1.1.0
Country	: Indonesian
City 	: Palembang

Quickstart

The First Step | The Second Step | The Third Step | The Fourth Step

More

Know More In | Header | Route | Config | Assets | Request | MVC | Controller | Middleware | Model | View | Url | Template

The First Step

top

Install composer in your opration system, if not installed you can download it from Composer website, after download and initialitation, next you need make composer.json files with contents as follows.

{
    "require": {
        "dnaextrim/kecik": "1.1.*@dev"
    }
}

next, run this command on console/cmd

composer install		

wait a minute until all run without error.

The Second Step

top

Create index.php files or anything, and enter the code below:

<?php
require_once "Kecik/Kecik.php";
// or for composer
require_once "vendor/autoload.php";

`require "Kecik\Kecik.php"` for include system file of framework to the project that you want make. then try run, if only displaying blank page without error message is mean successfull.

for how to use composer will not be discussed here, you can learn from documentation from composer website, both online and offline.

The Third Step

top

Create variable from Kecik Class as below

$app = new Kecik\Kecik();	

then try running back, if not get error is mean you have successfull in this step.

The Fourth Step

top

The next step is make Route for index and run the framework, following code:

$app->get('/', function() {
	return 'Hello Kecik';
});

$app->run();
			

Once the code is written try running, so you can see "Hello Kecik" that mean you have successfull make view for route index/main page for your project.

The overall appearance code:

<?php
require_once "Kecik/Kecik.php";
// or for composer
//require_once "vendor/autoload.php"

$app = new Kecik\Kecik();

$app->get('/', function() {
	return 'Hello Kecik';
});

$app->run();
			

Know More In

Header

top

Header use for do setting a response header

$app->get('hello', function() {
	$this->header(200);
	return 'Hello Kecik';
});

Route

top

Route in contained kecik framework current is get and post, where get and post is request source and that mean is that route just will proccess on match request.For how to use, there are several ways, and very simple is without use Controller, external variable and template, as follow:

$app->get('/', function() {
	return 'Hello Kecik';
});

With parameter:

$app->get('hello/:name', function ($name) {
	return 'Hello '.$name;
});

Parameter in route use `:at front section, while for optional parameter can use(:)`

> example: hello/(:name)

With Controller:

$app->get('welcome/:name', new Controller\Welcome($app), function ($controller, $name) use ($app) {
	return $controller->index($name);
});

Ensure that already makes Controller you want to use on that route.

With Template:

$app->get('hello/:name', function ($name) {
	return 'Hello '.$name;
})->template('template_kecik');

$app->get('welcome/:name', new Controller\Welcome($app), function ($controller, $name) use ($app) {
	return $controller->index($name);
})->template('template_kecik');

$app->get('welcome/:name', function($name) {
	$controller = new Controller\Welcome($this);
	return $controller->index($name);
})->template('template_kecik');

Group

Kecik Framework juga mendukung pengelompokan route.

$app->group('book', function() {
	$this->post('insert', function() {
		$controller = new Controller\Book($this);
		return $controller->insert();
	});
	
	$this->get('get', function() {
		$controller = new Controller\Book($this);
		return $controller->get();
	});

	$this->post('update', function() {
		$controller = new Controller\Book($this);
		return $controller->update();
	});

	$this->post('delete', function() {
		$controller = new Controller\Book($this);
		return $controller->delete();
	});
	
	$this->post('find', function() {
		$controller = new Controller\Book($this);
		return $controller->find();
	});
});

HTML just support method POST and GET, if we want using method like PUT, DELETE, OPTIONS, and PATCH we can using do Override

<form method="POST" action="<?php $this->url->to('login') ?>">
	<label>Username</label>
	<input type="text" name="username" />
	
	<label>Password</label>
	<input type="password" name="password" />
	
	<input type="hidden" name="_METHOD" value="PUT">
	
	<input type="submit" value="LOGIN" />
</form

> Note: Applies to the use of the post, put, delete, options, and patch to use the controller and templates there are several steps that need to be prepared

is()

Untuk mendapatkan nilai route saat ini

<a href="<?php $this->url->to('home') ?>" <?php echo ($this->route->is() == 'home')? 'class="active"': '' ?>>Home</a>

isPost()

Untuk mengecheck apakah metode request adalah POST, jika benar maka nilai adalah TRUE jika salah maka nilai adalah FALSE

if ($this->route->isPost() == FALSE)
	$this->header(404);

isGet()

Untuk mengecheck apakah metode request adalah GET, jika benar maka nilai adalah TRUE jika salah maka nilai adalah FALSE

if ($this->route->isGET() == FALSE)
	$this->header(404);

isPut()

Untuk mengecheck apakah metode request adalah PUT, jika benar maka nilai adalah TRUE jika salah maka nilai adalah FALSE

if ($this->route->isPut() == FALSE)
	$this->header(404);

isDelete()

Untuk mengecheck apakah metode request adalah DELETE, jika benar maka nilai adalah TRUE jika salah maka nilai adalah FALSE

if ($this->route->isDelete() == FALSE)
	$this->header(404);

isPatch()

Untuk mengecheck apakah metode request adalah PATCH, jika benar maka nilai adalah TRUE jika salah maka nilai adalah FALSE

if ($this->route->isPatch() == FALSE)
	$this->header(404);

isOptions()

Untuk mengecheck apakah metode request adalah OPTIONS, jika benar maka nilai adalah TRUE jika salah maka nilai adalah FALSE

if ($this->route->isOptions() == FALSE)
	$this->header(404);

isAjax()

Untuk mengecheck apakah metode request adalah AJAX, jika benar maka nilai adalah TRUE jika salah maka nilai adalah FALSE

if ($this->route->isAjax() == FALSE)
	$this->header(404);

First:

Setting path or location for assets, application (MVC), and template, following way setting:

$app->config->set('path.assets', 'assets');
$app->config->set('path.mvc', 'app');
$app->config->set('path.template', 'templates');

Second:

create a folder / directory by setting the path before.

Third:

For folder/directory assets and application sure in which there sub folder/direktori

+-- assets
|   +-- css
|   +-- js
|   +-- images

+--app
|  +-- controllers
|  +-- models
|  +-- views

Config

top

For a big project and not simple we need some setting/configuration, for setting/configuration this framework also equipped with config, either for setting or to read settings

set()

Use set function from config to a set/add value

set($key, $value)

> paramater `$key` is parameter key for a setting > > paramater `$value` is parameter value for a setting

Example:

$app->config->set('path.assets', 'assets');

get()

Use get function to get a value from a setting

get($key)

> parameter `$key` is key parameter for a setting where to get value

Example:

$asset_path = $app->config->get('path.assets');

Configuration When Making Kecik Instance

$config = [
	'path.assets'   => 'assets',
	'path.mvc'      => 'app',
	'path.template'	=> 'templates',
	'error.404'     => 'kecik_template/404',
	'mod_rewrite'	=> TRUE,
	
	'libraries' => [
		'DIC' => ['enable'=>TRUE],
		'Session' => [
			'enable' => TRUE,
			'config' => ['encrypt' => TRUE]
		],
		'Cookie' => [
			'enable' => TRUE,
			'config' => ['encrypt' => TRUE]
		],
		'Database' => [
			'enable' => TRUE,
			'config' => [
				'driver' => 'mysqli',
				'hostname' => 'localhost',
				'username' => 'root',
				'password' => '',
				'dbname' => 'kecik'
			]
		],
		'MVC' => ['enable' => TRUE],
		'Language' => [
			'enable' => TRUE,
			'params' => [
				'id' => 'language/lang_id.json',
				'us' => 'language/lang_us.json'
			]
		]
	]
];

$app = new Kecik\Kecik($config);

	$app->get('/', function() {
		return 'Hello Kecik';
	});
	
$app->run();

Assets

top

Assets is importan for facilitate us work for add/delete assets as css, js and images, also very useful for a template, and assets juga can be adjusted by controller in used. Assets css and js have same structure while for images is diferrent.

add()

This function use for add a assets file as css or js.

add($file='')

> paramater `$file` contains the name of the file that want to load assets, write without using extension

Example:

$app->assets->css->add('boostrap');
$app->assets->js->add('jquery.min');

delete()

This cunction use to delete a assets file that want to load as css or js.

delete($file='')

> paramater `$file` contains the name of the file that want to load assets, write without using extension

Example:

$app->assets->css->delete('boostrap');
$app->assets->js->delete('jquery.min');

render()

This function use to render a asset list or one asset that want to load as css or js

render($file='')

> paramater `$file` contains the name of the file that want to load assets, write without using extension

Example:

echo $app->assets->css->render();
echo $app->assets->js->render();
// atau spesifik render
echo $app->assets->css->render('boostrap');
echo $app->assets->js->render('boostrap.min');

images()

This function use to get link from image assets file.

images($file)

> paramater `$file` containt image assets file name that want to use.

Example:

<img src="<?php echo $app->assets->images('kecik.jpg'); ?>" />

url()

$this function use for get link of assets file for images.

url()

Request

top

Request is other use from `$_GET,$_POSTand$_SERVER`

get()

You can use get function to get value from `$_GET`

get($var='')

> paramater `$var` containt name from get variable

Example:

print_r($this->request->get());
$x = $this->request->get('x');

post()

You can use post function to get value from `$_POST`

post($var='')

> paramater `$var` containt name from post variable

Example:

print_r($this->request->post());
$x = $this->request->post('x');

put()

Anda dapat menggunakan fungsi post untuk mendapatkan nilai dari method put

put($var='')

> paramater `$var` berisikan nama dari variabel post

Contoh:

print_r($this->request->post());
$x = $this->request->post('x');

delete()

Anda dapat menggunakan fungsi post untuk mendapatkan nilai dari method delete

delete($var='')

> paramater `$var` berisikan nama dari variabel post

Contoh:

print_r($this->request->delete());
$x = $this->request->delete('x');

options()

Anda dapat menggunakan fungsi post untuk mendapatkan nilai dari method options

options($var='')

> paramater `$var` berisikan nama dari variabel post

Contoh:

print_r($this->request->options());
$x = $this->request->options('x');

patch()

Anda dapat menggunakan fungsi post untuk mendapatkan nilai dari method patch

patch($var='')

> paramater `$var` berisikan nama dari variabel post

Contoh:

print_r($this->request->patch());
$x = $this->request->patch('x');

file()

Anda dapat menggunakan fungsi post untuk mendapatkan nilai dari method file

file($file)

> paramater `$file` berisikan nama dari variabel FILES

Contoh:

$x = $this->request->file('photo')->move($source, $destination);

server()

You can use server function to get value from `$_SERVER`

server($var='')

> paramater `$var` containt name from server variable

Exmple:

print_r($this->request->server());
$host = $this->request->server('HTTP_HOST');

MVC

This Framework also support simple MVC, where route will call Controller and Controller will call Model or/and View.

Controller

top

For make controller is simple, we just make file with name as controller name and save into directory that setting before via config, The following simple code a controller

<?php
// file welcome.php
namespace Controller;

use Kecik\Controller;

class Welcome extends Controller{

	public function __construct($app) {
		parent::__construct($app);
	}
}

How to use the controller on the route is as follows:

$app->get('/', new Controller\Welcome($app), function($controller) {

});

• With Parameter
  To use the controller parameters on the way is also quite easy, just add a parameter to the constructor and when the controller is live input parameter constructor.
  <?php
  // file welcome.php
  namespace Controller;
  
  

var $dbcon;

public function __construct($app, $dbcon) {
	parent::__construct($app);
	$this->dbcon = $dbcon;
}

Next how to use at route as follow:

- With Method/Function
For use method/function in controller is simple, just call in callback section route. Here's how to write the code controller using the method / function.

var $dbcon;

public function __construct($app, $dbcon) {
	parent::__construct($app);
	$this->dbcon = $dbcon;
}

public function index() {
	return 'Kecik berkata: Controler->index()';
}

Next use method/function in route is as follow.

return $controller->index();

- With parameter in Method/Function
For give paramter in Method/Fungsi in controller we can give at the time of the call method in callback route, The following code example controller with a method / function parameterized.

var $dbcon;

public function __construct($app, $dbcon) {
	parent::__construct($app);
	$this->dbcon = $dbcon;
}

public function index() {
	return 'Kecik berkata: Controler->index()';
}

public function hello($nama) {
	return "Hello, $nama";
}

How to use in route as follow.

return $controller->index($nama);

Middleware
-----------------
top
Middleware is functions will running before/after callback execution on route.

echo 'is Middleware 1 [Before]';

echo 'is Middleware 2 [Before]';

echo 'is Middleware 3 [After]';

echo 'is Middleware 4 [After]';

return 'is Response Middleware Route';

Model
-------
top

For make model is simple, we just create a file with name as model name and save in directory that setting before via config, The following simple code model

protected $table = 'data';

public function __construct($id='') {
	parent::__construct($id);
}

How to use Model in controller are as follows.

var $dbcon;

public function __construct($app, $dbcon) {
	parent::__construct($app);
	$this->dbcon = $dbcon;
}

public function index() {
	return 'Kecik berkata: Controler->index()';
}

public function hello($nama) {
	return "Hello, $nama";
}

public function insert() {
	$model = new \Model\Data();
		$model->nama = $_POST['nama'];
		$model->email = $_POST['email'];
	$sql = $model->save();
}

public function update($id) {
	$model = new \Model\Data(array('id'=>$id));
		$model->nama = $_POST['nama'];
		$model->email = $_POST['email'];
	$sql = $model->save();
}

public function delete($id) {
	$model = new \Model\Data(array('id'=>$id));
	$sql = $mode->delete();
}

 
 View
------
top

For make view is also simple, because in this you don't need make class/object, but just plain php file will call by controller, the following code view.

How to use view file in controller are as follows.

public function __construct($app) {
	parent::__construct($app);
}

public function welcome() {
	return $this->view('welcome');
}

How to send variable to view are as follows:

public function __construct($app) {
	parent::__construct($app);
}

public function welcome($nama) {
	return $this->view('welcome', array('nama'=>$nama));
}

---
Url
----
top

Url is important for help jobs for get value like protocol, base path, base url, also redirect or make link to other route .

####protocol()
For get Protocol value

####basePath()
For get Base Path value

####baseUrl()
For Get Base Url value

####redirect($route)
For redirect to other route

####to($route)
For echo url with route

####linkTo($route)
For Get Url with Route value

---

Template
---------------
top

For make template in this framework is also simple, you just create template file in directory that you setting before via config. Here is a simple example of code templates

<head>
	<meta charset="utf-8" />
	<title>Simple Template</title>

	<meta name="description" content="overview &amp; stats" />
	<meta name="viewport" content="width=device-width, initial-scale=1.0" />
	
	@css
</head>
<body>

<div class="container">

    @response

</div>

	@js
</body>

> Sign {{ dan }} just subtitute tag <?php and > for echo you can use {{= it's same <?php echo while want using sign {{ and }} for AngularJS you can use sign \ after its, example \{{ atau \}}, this just simple template engine, but you use php tags.
> 
> The @response atau @yield is to put the output of the controller.
>
> The @css or  @js is to apply the template rendering assets

How to use the template on the route is as follows.

return $controller->welcome($nama);

Replace Template

if (!isset($_SESSION['login'])) {
	// Replace Template
	$this->template('login', TRUE);
} else {
	$controller = new Controller\Admin($this);
	return $controller->index();
}