. // }}} /** * Common utility functions * * @package GNUsocial * @category Util * * @author Hugo Sales * @copyright 2020 Free Software Foundation, Inc http://www.fsf.org * @license https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later */ namespace App\Util; use App\Core\DB\DB; use App\Core\Router; use App\Core\Security; use App\Entity\LocalUser; use App\Entity\Profile; use Functional as F; abstract class Common { /** * Access sysadmin's configuration preferences for GNU social */ public static function config(string $section, string $setting) { $c = DB::find('config', ['section' => $section, 'setting' => $setting]); if ($c === null) { throw new \Exception("The field section = {$section} and setting = {$setting} doesn't exist"); } return unserialize($c->getValue()); } /** * Set sysadmin's configuration preferences for GNU social * * @param mixed $value */ public static function setConfig(string $section, string $setting, $value): void { $c = DB::getPartialReference('config', ['section' => $section, 'setting' => $setting]); if ($c === null) { throw new \Exception("The field section = {$section} and setting = {$setting} doesn't exist"); } $c->setValue(serialize($value)); DB::flush(); } public static function user(): LocalUser { return Security::getUser(); } public static function profile(): Profile { return self::user()->getProfile(); } /** * Is the given string identical to a system path or route? * This could probably be put in some other class, but at * at the moment, only Nickname requires this functionality. */ public static function isSystemPath(string $str): bool { // TODO Implement return false; // $paths = []; // // All directory and file names in site root should be blacklisted // $d = dir(PUBLICDIR); // while (false !== ($entry = $d->read())) { // $paths[$entry] = true; // } // $d->close(); // // All top level names in the router should be blocked // $router = Router::get(); // foreach ($router->m->getPaths() as $path) { // if (preg_match('/^([^\/\?]+)[\/\?]/', $path, $matches) && isset($matches[1])) { // $paths[$matches[1]] = true; // } // } // // FIXME: this assumes the 'path' is in the first-level directory, though common it's not certain // foreach (['avatar', 'attachments'] as $cat) { // $paths[basename(common_config($cat, 'path'))] = true; // } // return in_arry($str, array_keys($paths)); } /** * Remove keys from the _values_ of $keys from the array $from */ public static function arrayRemoveKeys(array $from, array $keys, bool $strict = false) { return F\filter($from, function ($_, $key) use ($keys, $strict) { return !in_array($key, $keys, $strict); }); } /** * An internal helper function that converts a $size from php.ini for * file size limit from the 'human-readable' shorthand into a int. If * $size is empty (the value is not set in php.ini), returns a default * value (3M) * * @return int the php.ini upload limit in machine-readable format */ public static function sizeStrToInt(string $size): int { // `memory_limit` can be -1 and `post_max_size` can be 0 // for unlimited. Consistency. if (empty($size) || $size === '-1' || $size === '0') { $size = '3M'; } $suffix = substr($size, -1); $size = (int) substr($size, 0, -1); switch (strtoupper($suffix)) { case 'P': $size *= 1024; // no break case 'T': $size *= 1024; // no break case 'G': $size *= 1024; // no break case 'M': $size *= 1024; // no break case 'K': $size *= 1024; break; } return $size; } /** * Uses `size_str_to_int()` to find the smallest value for uploads in php.ini * * @return int */ public static function getPreferredPhpUploadLimit(): int { return min( self::sizeStrToInt(ini_get('post_max_size')), self::sizeStrToInt(ini_get('upload_max_filesize')), self::sizeStrToInt(ini_get('memory_limit')) ); } }