Details

tico

Mini, super-simple and versatile MVC Web Framework for PHP (v.1.22.0)

Uses:

1. Importer class & asset dependency loader
2. Dromeo versatile pattern router
3. InTpl simple php templates w/ inheritance
4. HttpFoundation, adapted from Symfony's HttpFoundation component (v.7.3.1 / 2025)

Hooks in order of execution:

serve normal response

1. `tico_before_serve`
2. `tico_before_middleware_before`
3. `tico_after_middleware_before`
4. `tico_before_route`
5. `tico_after_route`
6. `tico_before_middleware_after`
7. `tico_after_middleware_after`
8. `tico_prepared_response`
9. `tico_cache_response`
10. `tico_send_response`
11. `tico_after_serve`

serve cached response

1. `tico_serve_cache`
2. `tico_before_serve_cached`
3. `tico_after_serve_cached`

various hooks run in-between when data are set or changed:

1. `tico_request`, set request object
2. `tico_response`, set response object
3. `tico_set_callback`, change streamed output via callback
4. `tico_set_content`, change output content
5. `tico_set_file`, change/remove output file
6. `tico_redirect`, change/remove redirect url
7. `tico_autoload`, change/remove autoload classes
8. `tico_enqueue`, change/remove enqueued asset

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('views', [tico()->path('/views')])
 ->option('normalized_uris', true) // default
 ->option('normalize_uri', function($part) {
 return str_replace(array('?','?','?','?','?','?','?','?','?','?','?','?'), array('?','?','?','?','?','?','?','?','?','?','?','?'), mb_strtolower($part, 'UTF-8'));
 })
 /*->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
 ->set('cache', function() {
 // any custom caching solution can be used that has get/set methods, here a simple CacheManager
 include tico()->path('/cache/CacheManager.php');
 return (new CacheManager())
 ->option('cache_dur_sec', 10 60/10 minutes*/)
 ->option('cache_dir', tico()->path('/cache/data'))
 ;
 }) // container supports lazy factory-like functions
 ->hook('tico_before_serve_cached', function() {
 // a custom hook
 tico()->variable('tico_before_serve_cached__content', tico()->variable('tico_before_serve_cached__content')."\n\n<!--cached version-->");
 })
;
// if cache enabled and served, exit fast and early
(tico()->serveCache())
or
// else serve request normally, using full framework
(tico()
// 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'], // original msg
 'count'=> $session->get('count')
 ),
 'hello.tpl.php'
 );
})
// unicode normalized uris
->on(['get', 'post'], '/????/{:msg}', function($params) {
 $session = tico()->request()->getSession();
 $session->set('count', $session->get('count')+1);
 tico()->output(
 array(
 'title' => '????!',
 'msg' => $params[':']['msg'], // original msg
 'count'=> $session->get('count')
 ),
 'hello.tpl.php'
 );
})
// group routes under common prefix
->onGroup('/foo', function() {
 tico()
 // /foo
 ->on('*', '/', function() {
 tico()->output(
 array(
 'title' => 'Group Route',
 'msg' => 'Group Route /foo',
 'count'=> 0
 ),
 'hello.tpl.php'
 );
 })
 // /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())
;

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
• Localizer a simple and versatile localization class (l10n) for PHP, JavaScript, Python
• Importer simple class & dependency manager and loader for PHP, JavaScript, Python
• EazyHttp, easy, simple and fast HTTP requests 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

Close