elgglib.php

Go to the documentation of this file.

<?php
function elgg(): \Elgg\Di\PublicContainer {
    return \Elgg\Application::$_instance->public_services;
}

function elgg_set_http_header(string $header, bool $replace = true): void {
    if (!preg_match('~^HTTP/\\d\\.\\d~', $header)) {
        list($name, $value) = explode(':', $header, 2);
        _elgg_services()->responseFactory->setHeader($name, trim($value), $replace);
    }
}

function elgg_register_success_message(string|array $options): void {
    if (!is_array($options)) {
        $options = ['message' => $options];
    }
    
    $options['type'] = 'success';
    _elgg_services()->system_messages->addMessage($options);
}

function elgg_register_error_message(string|array $options): void {
    if (!is_array($options)) {
        $options = ['message' => $options];
    }
    
    $options['type'] = 'error';
    _elgg_services()->system_messages->addMessage($options);
}

function elgg_log($message, $level = \Psr\Log\LogLevel::NOTICE): void {
    _elgg_services()->logger->log($level, $message);
}

function elgg_dump($value): void {
    _elgg_services()->logger->dump($value);
}

function elgg_deprecated_notice(string $msg, string $dep_version): void {
    _elgg_services()->logger->warning("Deprecated in {$dep_version}: {$msg}");
}

function elgg_http_build_url(array $parts, bool $html_encode = true): string {
    return _elgg_services()->urls->buildUrl($parts, $html_encode);
}

function elgg_add_action_tokens_to_url(string $url, bool $html_encode = false): string {
    return _elgg_services()->urls->addActionTokensToUrl($url, $html_encode);
}

function elgg_http_remove_url_query_element(string $url, string $element): string {
    return _elgg_services()->urls->addQueryElementsToUrl($url, [$element => null]);
}

function elgg_http_add_url_query_elements(string $url, array $elements): string {
    return _elgg_services()->urls->addQueryElementsToUrl($url, $elements);
}

function elgg_http_url_is_identical(string $url1, string $url2, array $ignore_params = ['offset', 'limit']): bool {
    return _elgg_services()->urls->isUrlIdentical($url1, $url2, (array) $ignore_params);
}

function elgg_http_get_signed_url(string $url, string $expires = null): string {
    return _elgg_services()->urlSigner->sign($url, $expires);
}

function elgg_http_validate_signed_url(string $url): bool {
    return _elgg_services()->urlSigner->isValid($url);
}

function elgg_get_http_client(array $options = []): \Elgg\Http\Client {
    return new \Elgg\Http\Client($options);
}

function elgg_extract($key, $array, $default = null, bool $strict = true) {
    if (!is_array($array) && !$array instanceof ArrayAccess) {
        return $default;
    }

    if ($strict) {
        return $array[$key] ?? $default;
    }
    
    return (isset($array[$key]) && !empty($array[$key])) ? $array[$key] : $default;
}

function elgg_extract_class(array $array, array|string $existing = [], string $extract_key = 'class'): array {
    $existing = empty($existing) ? [] : (array) $existing;

    $merge = (array) elgg_extract($extract_key, $array, []);

    array_splice($existing, count($existing), 0, $merge);

    return array_values(array_filter(array_unique($existing)));
}

function elgg_call(int $flags, Closure $closure) {
    return _elgg_services()->invoker->call($flags, $closure);
}

function elgg_get_ini_setting_in_bytes(string $setting): int {
    // retrieve INI setting
    $val = ini_get($setting);

    // convert INI setting when shorthand notation is used
    $last = strtolower($val[strlen($val) - 1]);
    if (in_array($last, ['g', 'm', 'k'])) {
        $val = substr($val, 0, -1);
    }
    
    $val = (int) $val;
    switch ($last) {
        case 'g':
            $val *= 1024;
            // fallthrough intentional
        case 'm':
            $val *= 1024;
            // fallthrough intentional
        case 'k':
            $val *= 1024;
    }

    // return byte value
    return $val;
}

function _elgg_services(): \Elgg\Di\InternalContainer {
    // This yields a more shallow stack depth in recursive APIs like views. This aids in debugging and
    // reduces false positives in xdebug's infinite recursion protection.
    return \Elgg\Application::$_instance->internal_services;
}