anchor/helpers.php

<?php

use System\config;
use System\uri;

/**
 * translates a line of text
 *
 * @param string $line line to translate
 * @param string[] ...,  variables to replace
 *
 * @return mixed|string
 */
function __($line)
{
    $args = array_slice(func_get_args(), 1);

    return Language::line($line, null, $args);
}

/**
 * Checks whether the current request is on the admin panel
 *
 * @return bool
 * @throws \ErrorException
 * @throws \OverflowException
 */
function is_admin()
{
    // Exact URI or trailing slash after 'admin'.
    return Uri::current() === 'admin' || strpos(Uri::current(), 'admin/') === 0;
}

/**
 * Checks whether Anchor is installed
 *
 * @return bool
 */
function is_installed()
{
    return Config::get('db') !== null or Config::get('database') !== null;
}

/**
 * Creates a slug from a string
 *
 * @param string $string    string to slugify
 * @param string $separator separator character
 *
 * @return null|string|string[]
 */
function slug($string, $separator = '-')
{
    $accents_regex = '~&([a-zA-Z]{1,2})(?:acute|cedil|circ|grave|lig|orn|ring|slash|th|tilde|uml);~i';
    $special_cases = [
        '&' => 'and'
    ];
    $string        = mb_strtolower(trim($string), 'UTF-8');
    $string        = str_replace(array_keys($special_cases), array_values($special_cases), $string);
    $string        = preg_replace($accents_regex, '$1', htmlentities($string, ENT_QUOTES, 'UTF-8'));
    $string        = preg_replace("/[^a-zA-Z0-9]/u", "$separator", $string);
    $string        = preg_replace("/[$separator]+/u", "$separator", $string);
    $string        = trim($string, '-');

    return $string;
}

/**
 * parses a string, optionally using markdown
 *
 * @param string $str      string to parse
 * @param bool   $markdown whether to use markdown
 *
 * @return mixed|string parsed string
 */
function parse($str, $markdown = true)
{
    // process tags
    $pattern = '/[\{\{]{1}([a-z]+)[\}\}]{1}/i';

    if (preg_match_all($pattern, $str, $matches)) {
        list($search, $replace) = $matches;

        foreach ($replace as $index => $key) {
            $replace[$index] = Config::meta($key);
        }

        $str = str_replace($search, $replace, $str);
    }

    //  Parse Markdown as well?
    if ($markdown === true) {
        $md  = new Parsedown();
        $str = $md->text($str);
    }

    return $str;
}

/**
 * Calculate a user-readable file size
 *
 * @param int $size original size in byte
 *
 * @return string user-readable file size
 */
function readable_size($size)
{
    $unit = ['b', 'kb', 'mb', 'gb', 'tb', 'pb'];

    return round($size / pow(1024, ($i = floor(log($size, 1024)))), 2) . ' ' . $unit[$i];
}

/**
 * copies a filesystem tree recursively (aka. "cp -R")
 *
 * @param string $src source path
 * @param string $dst destination path
 *
 * @return void
 */
function recurse_copy($src, $dst)
{
    $dir = opendir($src);

    @mkdir($dst);

    while (false !== ($file = readdir($dir))) {
        if (($file != '.') && ($file != '..')) {
            if (is_dir($src . DS . $file)) {
                recurse_copy($src . DS . $file, $dst . DS . $file);
            } else {
                copy($src . DS . $file, $dst . DS . $file);
            }
        }
    }

    closedir($dir);
}

/**
 * deletes a filesystem tree recursively (aka. "rm -rf") by deleting all
 * individual files and folders within it
 *
 * @param string $dir directory to remove
 *
 * @return bool whether the
 */
function delTree($dir)
{
    $files = array_diff(scandir($dir), ['.', '..']);

    foreach ($files as $file) {
        (is_dir("$dir/$file")) ? delTree("$dir/$file") : unlink("$dir/$file");
    }

    return rmdir($dir);
}