] #
#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%#
# #
# The BigPipe main class is responsible for sorting and rendering the pagelets #
# and their associated resources. This class also provides methods to turn off #
# the pipeline mode or turn on the debugging mode. #
# #
#%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%#
namespace BigPipe;
class BigPipe {
private static $enabled = TRUE;
private static $pagelets = [];
#===============================================================================
# Check if pipelining mode is enabled
#===============================================================================
public static function isEnabled(): bool {
return self::$enabled;
}
#===============================================================================
# Enable or disable the pipelining mode
#===============================================================================
public static function setEnabled(bool $enabled): void {
self::$enabled = $enabled;
}
#===============================================================================
# Insert pagelet into queue
#===============================================================================
public static function enqueue(Pagelet $Pagelet): void {
self::$pagelets[spl_object_hash($Pagelet)] = $Pagelet;
}
#===============================================================================
# Remove pagelet from queue
#===============================================================================
public static function dequeue(Pagelet $Pagelet): void {
unset(self::$pagelets[spl_object_hash($Pagelet)]);
}
#===============================================================================
# Sends output buffer so far as possible towards user
#===============================================================================
public static function flushOutputBuffer(): void {
ob_flush(); flush();
}
#===============================================================================
# Renders all remaining pagelets from the queue in the appropriate order
#===============================================================================
public static function completeResponse(): void {
self::flushOutputBuffer();
$pagelets_ordered = [];
foreach(self::$pagelets as $Pagelet) {
$pagelets_ordered[$Pagelet->getPriority()][] = $Pagelet;
}
krsort($pagelets_ordered);
if(!empty($pagelets_ordered)) {
$pagelets = call_user_func_array('array_merge', $pagelets_ordered);
if(self::isEnabled()) {
foreach($pagelets as $Pagelet) {
$Pagelet->flush();
}
}
# NOTE: If BigPipe is disabled, Pagelet::flush() will NOT call BigPipe::dequeue().
# This means that (if the pipeline is disabled) $pagelets_ordered contains ALL
# Pagelets regardless of whether if Pagelet::flush() was already called. And then
# we can iterate over them and echo all requiered CSS and JS resources.
else {
foreach($pagelets as $Pagelet) {
foreach($Pagelet->getResources()[Resource::TYPE_STYLESHEET] as $Resource) {
echo "{$Resource->renderHTML()}\n";
}
foreach($Pagelet->getResources()[Resource::TYPE_JAVASCRIPT] as $Resource) {
echo "{$Resource->renderHTML()}\n";
}
foreach($Pagelet->getJSCode() as $JSCode) {
echo "\n";
}
}
}
}
if(self::isEnabled()) {
echo "\n";
}
}
}