misuzu/utility.php

<?php
function array_test(array $array, callable $func): bool {
    foreach($array as $value) {
        if(!$func($value)) {
            return false;
        }
    }

    return true;
}

function array_apply(array $array, callable $func): array {
    for($i = 0; $i < count($array); $i++) {
        $array[$i] = $func($array[$i]);
    }

    return $array;
}

function array_bit_or(array $array1, array $array2): array {
    foreach($array1 as $key => $value) {
        $array1[$key] |= $array2[$key] ?? 0;
    }

    return $array1;
}

function array_rand_value(array $array) {
    return $array[array_rand($array)];
}

function clamp($num, int $min, int $max): int {
    return max($min, min($max, intval($num)));
}

function starts_with(string $string, string $text, bool $multibyte = true): bool {
    $strlen = $multibyte ? 'mb_strlen' : 'strlen';
    $substr = $multibyte ? 'mb_substr' : 'substr';
    return $substr($string, 0, $strlen($text)) === $text;
}

function ends_with(string $string, string $text, bool $multibyte = true): bool {
    $strlen = $multibyte ? 'mb_strlen' : 'strlen';
    $substr = $multibyte ? 'mb_substr' : 'substr';
    return $substr($string, 0 - $strlen($text)) === $text;
}

function first_paragraph(string $text, string $delimiter = "\n"): string {
    $index = mb_strpos($text, $delimiter);
    return $index === false ? $text : mb_substr($text, 0, $index);
}

function camel_to_snake(string $camel): string {
    return trim(mb_strtolower(preg_replace('#([A-Z][a-z]+)#', '$1_', $camel)), '_');
}

function snake_to_camel(string $snake): string {
    return str_replace('_', '', ucwords($snake, '_'));
}

function unique_chars(string $input, bool $multibyte = true): int {
    $chars = [];
    $strlen = $multibyte ? 'mb_strlen' : 'strlen';
    $substr = $multibyte ? 'mb_substr' : 'substr';
    $length = $strlen($input);

    for($i = 0; $i < $length; $i++) {
        $current = $substr($input, $i, 1);

        if(!in_array($current, $chars, true)) {
            $chars[] = $current;
        }
    }

    return count($chars);
}

function byte_symbol(int $bytes, bool $decimal = false, array $symbols = ['', 'K', 'M', 'G', 'T', 'P', 'E', 'Z', 'Y']): string {
    if($bytes < 1) {
        return '0 B';
    }

    $divider = $decimal ? 1000 : 1024;
    $exp = floor(log($bytes) / log($divider));
    $bytes = $bytes / pow($divider, floor($exp));
    $symbol = $symbols[$exp];

    return sprintf("%.2f %s%sB", $bytes, $symbol, $symbol !== '' && !$decimal ? 'i' : '');
}

// For chat emote list, nuke this when Sharp Chat comms are in this project
function emotes_list(int $hierarchy = PHP_INT_MAX, bool $unique = false, bool $order = true): array {
    $getEmotes = \Misuzu\DB::prepare('
        SELECT    e.`emote_id`, e.`emote_order`, e.`emote_hierarchy`, e.`emote_url`,
                  s.`emote_string_order`, s.`emote_string`
        FROM      `msz_emoticons_strings` AS s
        LEFT JOIN `msz_emoticons` AS e
        ON        e.`emote_id` = s.`emote_id`
        WHERE     `emote_hierarchy` <= :hierarchy
        ORDER BY  IF(:order, e.`emote_order`, e.`emote_id`), s.`emote_string_order`
    ');
    $getEmotes->bind('hierarchy', $hierarchy);
    $getEmotes->bind('order', $order);
    $emotes = $getEmotes->fetchAll();

    // Removes aliases, emote with lowest ordering is considered the main
    if($unique) {
        $existing = [];

        for($i = 0; $i < count($emotes); $i++) {
            if(in_array($emotes[$i]['emote_url'], $existing)) {
                unset($emotes[$i]);
            } else {
                $existing[] = $emotes[$i]['emote_url'];
            }
        }
    }

    return $emotes;
}

function safe_delete(string $path): void {
    $path = realpath($path);

    if(empty($path)) {
        return;
    }

    if(is_dir($path)) {
        rmdir($path);
        return;
    }

    if(is_file($path)) {
        unlink($path);
    }
}

// mkdir but it fails silently
function mkdirs(string $path, bool $recursive = false, int $mode = 0777): bool {
    if(file_exists($path)) {
        return true;
    }

    return mkdir($path, $mode, $recursive);
}

function get_country_name(string $code): string {
    switch(strtolower($code)) {
        case 'xx':
            return 'Unknown';

        case 'a1':
            return 'Anonymous Proxy';

        case 'a2':
            return 'Satellite Provider';

        default:
            return locale_get_display_region("-{$code}", 'en');
    }
}

function pdo_prepare_array_update(array $keys, bool $useKeys = false, string $format = '%s'): string {
    return pdo_prepare_array($keys, $useKeys, sprintf($format, '`%1$s` = :%1$s'));
}

function pdo_prepare_array(array $keys, bool $useKeys = false, string $format = '`%s`'): string {
    $parts = [];

    if($useKeys) {
        $keys = array_keys($keys);
    }

    foreach($keys as $key) {
        $parts[] = sprintf($format, $key);
    }

    return implode(', ', $parts);
}

// render_error, render_info and render_info_or_json should be redone a bit better
// following a uniform format so there can be a global handler for em

function render_error(int $code, string $template = 'errors.%d'): string {
    return render_info(null, $code, $template);
}

function render_info(?string $message, int $httpCode, string $template = 'errors.%d'): string {
    http_response_code($httpCode);

    try {
        \Misuzu\Template::set('http_code', $httpCode);

        if(mb_strlen($message)) {
            \Misuzu\Template::set('message', $message);
        }

        $template = sprintf($template, $httpCode);

        /*if(!tpl_exists($template)) {
            $template = 'errors.master';
        }*/

        return \Misuzu\Template::renderRaw(sprintf($template, $httpCode));
    } catch(Exception $ex) {
        echo $ex->getMessage();
        return $message ?? '';
    }
}

function render_info_or_json(bool $json, string $message, int $httpCode = 200, string $template = 'errors.%d'): string {
    $error = $httpCode >= 400;
    http_response_code($httpCode);

    if($json) {
        return json_encode([($error ? 'error' : 'message') => $message, 'success' => $error]);
    }

    return render_info($message, $httpCode, $template);
}

function html_link(string $url, ?string $content = null, $attributes = []): string {
    $content = $content ?? $url;
    $attributes = array_merge(
        is_string($attributes) ? ['class' => $attributes] : $attributes,
        ['href' => $url]
    );

    if(mb_strpos($url, '://') !== false) {
        $attributes['target'] = '_blank';
        $attributes['rel'] = 'noreferrer noopener';
    }

    $html = '<a';

    foreach($attributes as $name => $value) {
        $value = str_replace('"', '\"', $value);
        $html .= " {$name}=\"{$value}\"";
    }

    $html .= ">{$content}</a>";

    return $html;
}

function html_colour(?int $colour, $attribs = '--user-colour'): string {
    $colour = $colour ?? colour_none();

    if(is_string($attribs)) {
        $attribs = [
            $attribs => '%s',
        ];
    }

    if(!$attribs) {
        $attribs = [
            'color' => '%s',
            '--user-colour' => '%s',
        ];
    }

    $css = '';
    $value = colour_get_css($colour);

    foreach($attribs as $name => $format) {
        $css .= $name . ':' . sprintf($format, $value) . ';';
    }

    return $css;
}

function html_avatar(int $userId, int $resolution, string $altText = '', array $attributes = []): string {
    $attributes['src'] = url('user-avatar', ['user' => $userId, 'res' => $resolution * 2]);
    $attributes['alt'] = $altText;
    $attributes['class'] = trim('avatar ' . ($attributes['class'] ?? ''));

    if(!isset($attributes['width']))
        $attributes['width'] = $resolution;
    if(!isset($attributes['height']))
        $attributes['height'] = $resolution;

    return html_tag('img', $attributes);
}

function html_tag(string $name, array $atrributes = [], ?bool $close = null, string $content = ''): string {
    $html = '<' . $name;

    foreach($atrributes as $key => $value) {
        $html .= ' ' . $key;

        if(!empty($value))
            $html .= '="' . $value . '"';
    }

    if($close === false)
        $html .= '/';

    $html .= '>';

    if($close === true)
        $html .= $content . '</' . $name . '>';

    return $html;
}