A fast and light-weight component library
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
therselman 1971af6118 Update README.md 7 years ago
src First major commit 7 years ago
LICENSE Initial commit 8 years ago
README.md Update README.md 7 years ago
composer.json 8 years ago

README.md

twister

Twister is a fast and light-weight micro-framework.

Actually, a more precise definition of this code release would be; Twister is a set of fast and light-weight components around which a framework can be written

At the heart of the framework, sits a very flexible, simple and elegant Inversion-of-Control (IoC) Container. In fact, there are NO global variables, NO define's, NO pipeline, NO Kernel and NO App; just the Container. The Container controls the entire flow of code (except routing), with a custom execute() function (written by you); which is actually just an anonymous callback function inside the Container, called from the Front Controller (index.php); even the name of that function can be changed in the config file. ie. There is NO pre-programmed flow of the program or hard-coded Kernel/App. Most things are handled/registered with the IoC Container, objects are pre-configured and lazy-loaded on request/use only!

Along with the Container, comes a very flexible and fast router (inside the Request class). I consider this router to be THE fastest router I've tested, with the same functionality. It includes the ability to filter by method (GET/POST), and optional parameters like /user/{id}[/{name}] Another somewhat unique capability is the ability to pre-define the patterns associated with named parameters eg. id->\d+ So everytime you specify {id}, {date} etc. in any route, the same patterns are re-used,         or you can specify custom patterns with {id:[0-9]+} or {id:uuid} where uuid=>[A-F0-9-]+ etc.    Two design choices make the router fast: 1) Everything is configured/loaded from a config array (which is usually cached by APC/Xcode/PHP7) 2) The router splits the request uri by '/', doing an isset array lookup for the first path segment 3) The router only takes further action after the first segment (eg. /admin/, /login etc.) is resolved

Although Twister is a fully functional and useable framework (based on my personal framework), it's more a proof-of-concept for me to demonstrate my capabilities and design decisions.

Benchmarks:

All tests were done with a skeleton hello world application on the same PC. Laravel and Symfony were NOT configured to establish a database connection, while Twister WAS! With a database connection, Symfony dropped to 9-12 requests per second, and Laravel 12-16 rps, Twister was running about 50x-100x faster than Symfony and Laravel

ab -t 30 http://laravel/

Complete requests: 198 Requests per second: 6.59 [#/sec] (mean) Time per request: 151.765 [ms] (mean)

memory_get_usage(): 6,621,416 memory_get_usage(true): 2,097,152 memory_get_peak_usage(): 6,691,272 memory_get_peak_usage(true): 2,097,152

ab -t 30 http://symfony/

Complete requests: 95 Requests per second: 3.15 [#/sec] (mean) Time per request: 317.717 [ms] (mean)

memory_get_usage(): 10,887,352 memory_get_usage(true): 4,194,304 memory_get_peak_usage(): 11,168,984 memory_get_peak_usage(true): 4,194,304

ab -t 30 http://twister/

Complete requests: 911 Requests per second: 30.35 [#/sec] (mean) Time per request: 32.952 [ms] (mean)

memory_get_usage(): 858,848 memory_get_usage(true): 2,097,152 memory_get_peak_usage(): 1,049,528 memory_get_peak_usage(true): 2,097,152