| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387 |
- <?php
- class Util {
- /**
- * @param string|null $gender
- * @return string
- */
- public static function getGenderText(?string $gender): string {
- switch($gender) {
- case "M": return MALE;
- case "F": return FEMALE;
- default: return "";
- }
- }
- /**
- * @param string|null $boolean
- * @return string
- */
- public static function getBooleanText(?string $boolean): string {
- switch($boolean) {
- case "Y": return YES;
- case "N": return NO;
- default: return "";
- }
- }
- /**
- * @param string $string
- * @param string $target_encoding
- * @return string
- */
- public static function convertUTF8(string $string, string $target_encoding = "CP1252"): string {
- return mb_convert_encoding($string, $target_encoding, "UTF-8");
- }
- /**
- * @param array $items
- * @param int $page_size
- * @return object
- * @throws Exception
- */
- public static function getPaginationObject(array $items, int $page_size = 25) {
- $item_count = count($items);
- $page = http::value("page");
- if($page < 1) $page = 1;
- $offset = ($page - 1) * $page_size;
- $page_count = ceil($item_count / $page_size);
- if($page_count < 1) $page_count = 1;
- $first_item = ($offset + 1);
- $last_item = $offset + $page_size;
- if($last_item > $item_count) {
- $last_item = $item_count;
- }
- if($page_count == 1) {
- $range_text = "Showing $item_count items";
- }
- else {
- $range_text = "Showing $first_item - $last_item of $item_count items";
- }
- return (object) [
- "page" => $page,
- "pageCount" => $page_count,
- "pageSize" => $page_size,
- "offset" => $offset,
- "firstItem" => $first_item,
- "lastItem" => $last_item,
- "rangeText" => $range_text
- ];
- }
- /**
- * @param string $folder
- * @param int $id
- * @return string
- */
- public static function getItemDirectory(string $folder, int $id): string {
- $shard = str_pad($id % 1000, 3, "0", STR_PAD_LEFT);
- return ROOT_DIR . "/files/" . $folder . "/" . $shard . "/" . $id;
- }
- /**
- * @param string $folder
- * @param int $id
- * @return string
- */
- public static function createItemDirectory(string $folder, int $id): string {
- $directory = Util::getItemDirectory($folder, $id);
- if(!file_exists($directory)) {
- mkdir($directory, 0777, true);
- }
- return $directory;
- }
- /**
- * @param string $string
- * @param string $glue
- * @return string
- */
- public static function slug(string $string, string $glue = "-"): string {
- $slug = strtolower($string);
- $slug = preg_replace("/[^\da-z]/i", $glue, $slug); // Replace anything not 0-9 a-z with glue
- $slug = preg_replace("/" . preg_quote($glue, "/") . "+/", $glue, $slug); // Replace consequential glue with dash
- return trim($slug, $glue);
- }
- /**
- * @param string $string
- * @param int $id
- * @return string
- */
- public static function slugWithId(string $string, int $id): string {
- return Util::slug($string) . "-" . $id;
- }
- /**
- * @param int $size
- * @return string
- */
- public static function getDisplayFileSize(int $size): string {
- if($size < pow(2, 10)) return number_format($size) . " bytes";
- if($size < pow(2, 20)) return number_format($size / pow(2, 10), 2) . " KB";
- if($size < pow(2, 30)) return number_format($size / pow(2, 20), 2) . " MB";
- if($size < pow(2, 40)) return number_format($size / pow(2, 30), 2) . " GB";
- return number_format($size / pow(2, 40), 2) . " TB";
- }
- /**
- * @param int $unix_time
- * @param array $options
- * @return string
- */
- public static function timeDifference(int $unix_time, $options = []): string {
- $plain = $options["plain"] ?? false;
- $now = time();
- $difference = $now - $unix_time;
- $tense = ($difference >= 0) ? "ago" : "to go";
- $difference = abs($difference);
- if($difference < 60) {
- $value = $difference;
- $class = "text-danger";
- $unit = "second";
- }
- else if($difference < 3600) {
- $value = floor($difference / 60);
- $class = "text-danger";
- $unit = "minute";
- }
- else if($difference < 86400) {
- $value = floor($difference / 3600);
- $class = "text-warning";
- $unit = "hour";
- }
- else if($difference < 2592000) {
- $value = floor($difference / 86400);
- $class = "";
- $unit = "day";
- }
- else if($difference < 31536000) {
- $value = floor($difference / 2592000);
- $class = "text-muted";
- $unit = "month";
- }
- else {
- $value = floor($difference / 31536000);
- $class = "text-muted";
- $unit = "year";
- }
- $text = "$value $unit" . ($value != 1 ? "s" : "") . " $tense";
- if($plain) {
- return "$text";
- }
- else {
- return "<span class=\"$class\">$text</span>";
- }
- }
- /**
- * @return array
- * @throws Exception
- */
- public static function getTimeZones(): array {
- // Taken and modified from: https://stackoverflow.com/a/17355238
- static $regions = [
- DateTimeZone::AFRICA,
- DateTimeZone::AMERICA,
- DateTimeZone::ANTARCTICA,
- DateTimeZone::ASIA,
- DateTimeZone::ATLANTIC,
- DateTimeZone::AUSTRALIA,
- DateTimeZone::EUROPE,
- DateTimeZone::INDIAN,
- DateTimeZone::PACIFIC,
- ];
- $identifiers = [];
- foreach($regions as $region) {
- $identifiers = array_merge($identifiers, DateTimeZone::listIdentifiers($region));
- }
- $time_zone_offsets = [];
- foreach($identifiers as $identifier) {
- $tz = new DateTimeZone($identifier);
- $time_zone_offsets[] = (object) [
- "identifier" => $identifier,
- "offset" => $tz->getOffset(new DateTime),
- ];
- }
- uasort($time_zone_offsets, function($a, $b) {
- if($a->offset > $b->offset) return 1;
- else if($a->offset < $b->offset) return -1;
- else return strcasecmp($a->identifier, $b->identifier);
- });
- $sr = [
- "/" => ", ",
- "St" => "St.",
- "_" => " ",
- ];
- $time_zone_list = [];
- foreach($time_zone_offsets as $object) {
- $identifier = $object->identifier;
- $offset = $object->offset;
- $display_identifier = str_replace(array_keys($sr), array_values($sr), $identifier);
- $offset_prefix = $offset < 0 ? "-" : "+";
- $offset_formatted = gmdate("H:i", abs($offset));
- $pretty_offset = "UTC${offset_prefix}${offset_formatted}";
- $time_zone_list[$identifier] = "${pretty_offset} - $display_identifier";
- }
- return $time_zone_list;
- }
- /**
- * @param bool $time
- * @return string
- */
- public static function getDate($time = false): string {
- if(!$time) $time = time();
- return gmdate("Y-m-d", $time);
- }
- /**
- * @param bool $time
- * @return string
- */
- public static function getUTCDateTime($time = false): string {
- return Util::getDateTime($time);
- }
- /**
- * @param bool $time
- * @return string
- */
- public static function getDateTime($time = false): string {
- if(!$time) $time = time();
- return gmdate("Y-m-d H:i:s", $time);
- }
- /**
- * @param string $dts
- * @return false|int
- */
- public static function getUnixTimeFromUTC(string $dts) {
- return strtotime($dts . " UTC");
- }
- /**
- * @param string $dts1
- * @param string $dts2
- * @return float|int
- */
- public static function getDurationFromDTS(string $dts1, string $dts2) {
- $tz = date_default_timezone_get();
- date_default_timezone_set("UTC");
- $t1 = strtotime($dts1);
- $t2 = strtotime($dts2);
- date_default_timezone_set($tz);
- return abs($t2 - $t1);
- }
- /**
- * @param int|bool $time
- * @return string
- */
- public static function getDisplayDateTime($time = false): string {
- if($time === false) $time = time();
- $current_year = date("Y");
- $year = date("Y", $time);
- $format = ($year == $current_year) ? "M j, H:i" : "M j Y, H:i";
- return date($format, $time);
- }
- /**
- * @param int|bool $time
- * @return string
- */
- public static function getDisplayDate($time = false): string {
- if($time === false) $time = time();
- $current_year = date("Y");
- $year = date("Y", $time);
- $format = ($year == $current_year) ? "M j" : "M j Y";
- return date($format, $time);
- }
- /**
- * @param string $dts
- * @return string
- */
- public static function getDisplayDateTimeFromUTC(string $dts): string {
- $unix = Util::getUnixTimeFromUTC($dts);
- return Util::getDisplayDateTime($unix);
- }
- /**
- * @param array $array
- * @param string $field
- * @param string $compare_function
- * @return array
- */
- public static function sortObjectArray(array $array, string $field, string $compare_function = ""): array {
- usort($array, function($a, $b) use ($compare_function, $field) {
- switch($compare_function) {
- default:
- if($a->$field == $b->$field) return 0;
- return ($a->$field < $b->$field) ? -1 : 1;
- case "strnatcasecmp":
- return strnatcasecmp($a->$field, $b->$field);
- }
- });
- return $array;
- }
- /**
- * @param array $input
- * @return array
- */
- public static function arrayFlipByID(array $input = []): array {
- $output = [];
- foreach($input as $object) {
- $output[$object->getID()] = $object;
- }
- return $output;
- }
- }
|