lepton_tools.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
class LEPTON_tools
{
    static public bool $use_var_dump = false;
 
    static public function use_var_dump(bool $bUseVarDump=true): void
    {
        self::$use_var_dump = $bUseVarDump;
    }
 
    static function display(
        mixed       $something_to_display ="",
        string      $tag="pre",
        string|null $css_class = null,
        bool|null   $useVarDump = null
    ): string
    {
        if (is_null($something_to_display))
        {
            $something_to_display = "The value is NULL!";
        }
        
        // [0] useVarDump?
        $useVarDumpParam = is_bool($useVarDump)
            ? (bool)$useVarDump
            : false
            ;
            
        $sReturnVal = "\n<".$tag.(null === $css_class ? "" : " class='".$css_class."'").">\n";
        ob_start();
            ((true === self::$use_var_dump) || (true === $useVarDumpParam))
            ? var_dump($something_to_display)
            : print_r($something_to_display)
            ;
        $sReturnVal .= ob_get_clean();
        $sReturnVal .= "\n</".$tag.">\n";
 
        return $sReturnVal;
    }
 
    static function display_dev(
        mixed       $something_to_display = "",
        string      $tag = "pre",
        string|null $css_class = null,
        bool|null   $useVarDump = null
    ): string
    {
        if (is_null($something_to_display))
        {
            $something_to_display = "The value is NULL!";
        }
        // [0] useVarDump?
        $useVarDumpParam = is_bool($useVarDump)
            ? (bool)$useVarDump
            : false
            ;
        
        // [1] get 'caller'
        $backtrace = debug_backtrace();
        $sOriginInfo = "<none>";
        if (isset($backtrace[0]['file']))
        {
            $sFormated = "<b>Location: %s ->Line %s</b>\n<br>";
            $sOriginInfo = sprintf(
                    $sFormated,
                    str_replace(LEPTON_PATH, "~", $backtrace[0]['file']),
                    $backtrace[0]['line']
                );
            
        }
        // [2] start return string
        $s = "\n<".$tag.(null === $css_class ? "" : " class='".$css_class."'").">\n";
        $s .= $sOriginInfo;
        ob_start();
            ((true === self::$use_var_dump) || (true === $useVarDumpParam))
            ? var_dump($something_to_display)
            : print_r($something_to_display)
            ;
        $s .= ob_get_clean();
        $s .= "\n</".$tag.">\n";
 
        return $s;
    }
 
    // create signature image
    static function base64ToImage(string $base64_string, string $output_file): string
    {
        $file = fopen($output_file, "wb"); // write binary!
 
        $data = explode(',', $base64_string);
 
        fwrite($file, base64_decode($data[1]));
        fclose($file);
 
        return $output_file;
    }
}