yarri / lazy-loader
LazyLoader provides efficient mechanism for lazy loading with closures
Installs: 21 571
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: >=7.1
- atk14/stop-watch: 0.*
- atk14/string4: 0.* >=0.1.1
Requires (Dev)
- atk14/tester: *
README
LazyLoader provides efficient mechanism for lazy loading with closures.
In LazyLoader one or more named closures can be defined. Any closure is called at most once when its output is needed.
Basic Usage
LazyLoader implements ArrayAccess, thus the easiest way how to use is like an associative array.
$lazy_loader = new LazyLoader();
// Setting up a closure,
$lazy_loader["recent_articles"] = function(){
return Article::FindAll(["order_by" => "published_at DESC", "limit" => 10]);
};
// ... another closure
$lazy_loader["top_product"] = function(){
return Product::FindFirst(["order_by" => "pieces_sold DESC"]);
}
// Reading - closure is being executed only during the first occurence of reading
if($lazy_loader["recent_articles"]){
foreach($lazy_loader["recent_articles"] as $article){
// ...
}
}
//
$top_product = $lazy_loader["top_product"];
There are total three ways how to set a closure or get its output. All of them do the same thing and can be mixed.
// Setting a closure
$lazy_loader->set("recent_articles",function(){ /* ... */ });
// or
$lazy_loader["recent_articles"] = function(){ /* ... */ };
// or
$lazy_loader->setRecentArticles(function(){ /* ... */ });
// Getting the output
$recent_articles = $lazy_loader->get("recent_articles");
// or
$recent_articles = $lazy_loader["recent_articles"];
// or
$recent_articles = $lazy_loader->getRecentArticles();
Also arguments can be involved. In this case the usage of camelized virtual methods comes in handy.
$lazy_loader->setRecentArticles(function($limit = 10){
return Article::FindAll(["order_by" => "published_at DESC", "limit" => $limit]);
});
$five_recent_articles = $lazy_loader->getRecentArticles(5);
Usage in a template engine
LazyLoader can be gracefully used in any template engine, for instance in the Smarty.
Preparing data for a Smarty template:
$smarty->assign("lazy_loader",$lazy_loader);
In a Smarty template:
<h3>Recent Articles</h3>
<ul>
{foreach $lazy_loader.recent_articles as $article}
<li><a href="{$article->getUrl()}">{$article->getTitle()}</a></li>
{/foreach}
</ul>
Usage in the ATK14 Framework
<?php
// file: app/controllers/application.php
class ApplicationController extends Atk14Controller {
// ..
function _before_render(){
$lazy_loader = new $lazy_loader;
$lazy_loader["recent_articles"] = function(){
return Article::FindAll(["order_by" => "published_at DESC", "limit" => 10]);
};
$this->tpl_data["lazy_loader"] = $lazy_loader;
}
}
Recent articles are displayed on every page in the sidebar. So caching is appropriate.
{* file: app/layouts/default.tpl *}
{cache key=sidebar expire=600}
<div class="sidebar">
{render partial="shared/recent_articles" recent_articles=$lazy_loader.recent_articles}
</div>
{/cache}
A shared template doesn't have to know anything about lazy loading.
{* file: app/views/shared/_recent_articles.tpl *}
<h3>Recent Articles</h3>
<ul>
{foreach $recent_articles as $article}
<li><a href="{$article->getUrl()}">{$article->getTitle()}</a></li>
{/foreach}
</ul>
As you may expected, the "recent_articles" closure is executed only when the cache is re-created.
Tracy panel integration
LazyLoader package comes with LazyLoaderPanel for easy integration into the popular debugger Tracy (https://packagist.org/packages/tracy/tracy)
$tracy_bar = Tracy\Debugger::getBar();
$tracy_bar->addPanel(new LazyLoaderPanel($lazy_loader));
Installation
The best way how to install LazyLoader is to use a Composer:
composer require yarri/lazy-loader
Testing
Install required dependencies for development:
composer update --dev
Run tests:
./test/run_tests.sh
License
LazyLoader is free software distributed under the terms of the MIT license