tico
Tiny, super-simple but versatile quasi-MVC web framework for PHP (v.1.13.0)
see also:
- ModelView a simple, fast, powerful and flexible MVVM framework for JavaScript
- tico a tiny, super-simple MVC framework for PHP
- LoginManager a simple, barebones agnostic login manager for PHP, JavaScript, Python
- SimpleCaptcha a simple, image-based, mathematical captcha with increasing levels of difficulty for PHP, JavaScript, Python
- Dromeo a flexible, and powerful agnostic router for PHP, JavaScript, Python
- PublishSubscribe a simple and flexible publish-subscribe pattern implementation for PHP, JavaScript, Python
- Importer simple class & dependency manager and loader for PHP, JavaScript, Python
- Contemplate a fast and versatile isomorphic template engine for PHP, JavaScript, Python
- HtmlWidget html widgets, made as simple as possible, both client and server, both desktop and mobile, can be used as (template) plugins and/or standalone for PHP, JavaScript, Python (can be used as plugins for Contemplate)
- Paginator simple and flexible pagination controls generator for PHP, JavaScript, Python
- Formal a simple and versatile (Form) Data validation framework based on Rules for PHP, JavaScript, Python
- Dialect a cross-vendor & cross-platform SQL Query Builder, based on GrammarTemplate, for PHP, JavaScript, Python
- DialectORM an Object-Relational-Mapper (ORM) and Object-Document-Mapper (ODM), based on Dialect, for PHP, JavaScript, Python
- Unicache a simple and flexible agnostic caching framework, supporting various platforms, for PHP, JavaScript, Python
- Xpresion a simple and flexible eXpression parser engine (with custom functions and variables support), based on GrammarTemplate, for PHP, JavaScript, Python
- Regex Analyzer/Composer Regular Expression Analyzer and Composer for PHP, JavaScript, Python
Uses:
Importerclass & asset dependency loaderDromeoversatile pattern routerInTplsimple php templates w/ inheritanceHttpFoundationadapted from Symfony's HttpFoundation component
demo (see /demo/index.php)
define('ROOT', dirname(__FILE__));
include(ROOT . '/../tico/Tico.php');
class MyModel
{
public function getMsg()
{
return "Hello";
}
}
tico('http://localhost:8000', ROOT)
// some options
->option('webroot', ROOT) // default
->option('case_insensitive_uris', true) // default
->option('views', [tico()->path('/views')])
/*->option('tpl_render', function($tpl, $data, $viewsFolders) {
// custom template renderer
return MyFancyTpl::render($tpl, $data);
})*/
//->set('model', new MyModel()) // simple dependency injection container
->set('model', function() {
return new MyModel();
}) // container supports lazy factory-like functions
// middleware functionality
->middleware(function($next) {
// eg check if user is authenticated,
// for example check user cookie and set user var appropriately
tico()->set('user', tico()->request()->cookies->get('user', 'guest'));
// start session example (eg native php session)
$session = new HttpSession(/*array(..)*/);
tico()->request()->setSession($session);
$session->start();
if (!$session->has('count')) $session->set('count', 0);
$next();
})
->middleware(function($next) {
// if this condition is met, abort current request, eg user is not authenticated
if (('guest'==tico()->get('user')) && ('/hello/foo'==tico()->requestPath()))
//tico()->redirect(tico()->uri('/hello/bar'), 302);
tico()->output(
array('title' => 'Hello!', 'msg' => 'guest'),
'hello.tpl.php'
);
// else pass along
else
$next();
})
// can handle other ports from same script, as long as handling is directed to this file
// on :4040 port, '*' means on any port
->onPort(4040, function() {
tico()
->on('*', '/', function() {
tico()->output(
array('title' => 'Demo Port Index'),
'4040/index.tpl.php'
);
})
->on(false, function() {
tico()->output(
array(),
'4040/404.tpl.php',
array('StatusCode' => 404)
);
})
;
})
// can handle subdomains from same script, as long as subdomain handling is directed to this file
// on "foo." subdomain, '*' means on any subdomain
->onSubdomain('foo', function() {
tico()
->on('*', '/', function() {
tico()->output(
array('title' => 'Demo Subdomain Index'),
'foo/index.tpl.php'
);
})
->on(false, function() {
tico()->output(
array(),
'foo/404.tpl.php',
array('StatusCode' => 404)
);
})
;
})
// on main domain / port
->on('*', '/', function() {
tico()->output(
array('title' => 'Demo Index'),
'index.tpl.php'
);
})
->on(['get', 'post'], '/hello/{:msg}', function($params) {
$session = tico()->request()->getSession();
$session->set('count', $session->get('count')+1);
tico()->output(
array(
'title' => 'Hello!',
'msg' => $params['msg'],
'count'=> $session->get('count')
),
'hello.tpl.php'
);
})
// group routes under common prefix
->onGroup('/foo', function() {
tico()
// /foo/moo
->on('*', '/moo', function() {
tico()->output(
array(
'title' => 'Group Route',
'msg' => 'Group Route /foo/moo',
'count'=> 0
),
'hello.tpl.php'
);
})
// /foo/koo
->onGroup('/koo', function() {
tico()
// /foo/koo
->on('*', '/', function() {
tico()->output(
array(
'title' => 'Group Route',
'msg' => 'Group Route /foo/koo',
'count'=> 0
),
'hello.tpl.php'
);
})
// /foo/koo/soo
->on('*', '/soo', function() {
tico()->output(
array(
'title' => 'Group Route',
'msg' => 'Group Route /foo/koo/soo',
'count'=> 0
),
'hello.tpl.php'
);
})
;
})
;
})
->on('*', '/json/api', function() {
tico()->output(array(
'param1' => '123',
'param2' => '456',
'param3' => '789'
), 'json');
})
->on('*', '/download', function() {
tico()->output(
tico()->path('/file.txt'),
'file'
);
})
->on('*', '/redirect', function() {
tico()->redirect(tico()->uri('/'), 302);
})
->on(false, function() {
tico()->output(
array(),
'404.tpl.php',
array('StatusCode' => 404)
);
})
// middlewares are same for main domain and all subdomains and all ports
->middleware(function($next) {
// post process, eg create cache files from response
if ((200 == tico()->response()->getStatusCode()) && 'text/html'==tico()->response()->headers->get('Content-Type') && !tico()->response()->getFile() && !tico()->response()->getCallback())
{
tico()->response()->setContent(tico()->response()->getContent().'<!-- post processed -->');
}
}, 'after')
->serve()
;