debug_log - utility for printing to debug output

debug_log.php

<?php


/**
 * debug_log
 * @param {*}      $data
 * @param {string} $d = "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "bold" | "dim" | "italic" | "underline" | "inverse" | "hidden" | "strikethrough"
 * */
function debug_log($data, $type = ''){

    $patterns = [
        "black"         => "str",
        "red"           => "str",
        "green"         => "str",
        "yellow"        => "str",
        "blue"          => "str",
        "magenta"       => "str",
        "cyan"          => "str",
        "white"         => "str",
        "gray"          => "str",
        "bold"          => "str",
        "dim"           => "str",
        "italic"        => "str",
        "underline"     => "str",
        "inverse"       => "str",
        "hidden"        => "str",
        "strikethrough" => "str",
    ];

    if (!is_string($data) && !is_numeric($data)) {
        $data = json_encode($data, JSON_PRETTY_PRINT);
    }

    if ($type && isset($patterns[$type])) {
        $pattern = $patterns[$type];
        $data = str_replace('str', $data, $pattern);
    }

    file_put_contents('php://stderr', $data);
    file_put_contents('php://stderr', "\n");
}