The Framework Code

File List

<?php
/**
 * Contains definition of Debug class
 *
 * @author Lindsay Marshall <lindsay.marshall@ncl.ac.uk>
 * @copyright 2014-2021 Newcastle University
 * @package Framework
 * @subpackage SystemSupport
 */
    namespace Framework\Support;

/**
 * A class that handles various debugging related things
 */
    class Debug
    {
        private static $fd = FALSE; // file descriptor
        private static int $hcount = 0; // header count
/**
 * Set up the debug text file
 */
        private static function setup() : void
        {
            if (self::$fd === FALSE)
            {
                self::$fd = \fopen(\Framework\Local::getinstance()->makebasepath('debug', 'debug.txt'), 'a');
            }
        }
/**
 * Display a string
 */
        public static function show(string $str) : void
        {
            self::setup();
            /** @psalm-suppress PossiblyFalseArgument  */
            \fputs(self::$fd, $str."\n");
        }
/**
 * Dump a variable - uses buffering to grab the output.
 */
        public static function vdump(...$vars) : void
        {
            self::setup();
            \ob_start();
            /** @psalm-suppress ForbiddenCode */
            \var_dump(...$vars);
            /** @psalm-suppress PossiblyFalseArgument  */
            \fputs(self::$fd, \ob_get_clean());
        }
/**
 * Flush the output stream
 */
        public static function flush() : void
        {
            if (self::$fd !== FALSE)
            {
                /** @psalm-suppress PossiblyFalseArgument  */
                \fflush(self::$fd);
            }
        }
/**
 * Display a string in an X-DEBUG-INFO header
 */
        public static function head(string $str) : void
        {
            self::$hcount += 1;
            \header('X-DEBUG-INFO'.self::$hcount.': '.$str);
        }
    }
?>