beestat/api/index.php

<?php

/**
 * Entry point for the API. This sets up cora, the error/exception handlers,
 * and then sends the request off for processing. All requests should start
 * here.
 *
 * @author Jon Ziebell
 */

// Compress output.
ob_start('ob_gzhandler');

// Set a reasonable time limit.
set_time_limit(5);

// Turn on all error reporting but disable displaying errors.
error_reporting(-1);
ini_set('display_errors', '0');

date_default_timezone_set('UTC');

// Autoload classes as necessary so there are no includes/requires. Note that
// calling spl_autoload_register() with no arguments is actually faster than
// this. The only reason I'm defining this function is because the default
// autoloader lowercases everything which tends to break other libraries.
spl_autoload_register(function($class) {
  include str_replace('\\', '/', $class) . '.php';
});

// Construct request and set up error handlers.
$request = cora\request::get_instance();
set_error_handler([$request, 'error_handler']);
set_exception_handler([$request, 'exception_handler']);

// The shutdown handler will output the response.
register_shutdown_function([$request, 'shutdown_handler']);

$post_body = file_get_contents('php://input');
if($post_body !== '') {
  $data = json_decode($post_body, true);
} else {
  $data = $_REQUEST;
}

// Go!
$request->process($data);

// Useful function
function array_median($array) {
  $count = count($array);

  if($count === 0) {
    return null;
  }

  $middle = floor($count / 2);
  sort($array, SORT_NUMERIC);
  $median = $array[$middle]; // assume an odd # of items
  // Handle the even case by averaging the middle 2 items
  if ($count % 2 == 0) {
    $median = ($median + $array[$middle - 1]) / 2;
  }
  return $median;
}

// Useful function
function array_mean($array) {
  $count = count($array);

  if($count === 0) {
    return null;
  }

  return array_sum($array) / $count;
}

// Useful function
function array_standard_deviation($array) {
  $count = count($array);

  if ($count === 0) {
    return null;
  }

  $mean = array_mean($array);

  $variance = 0;
  foreach($array as $i) {
    $variance += pow(($i - $mean), 2);
  }

  return round(sqrt($variance / $count), 2);
}

/**
 * Convert a local datetime string to a UTC datetime string.
 *
 * @param string $local_datetime Local datetime string.
 * @param string $local_time_zone The local time zone to convert from.
 *
 * @return string The UTC datetime string.
 */
function get_utc_datetime($local_datetime, $local_time_zone, $format = 'Y-m-d H:i:s') {
  $local_time_zone = new DateTimeZone($local_time_zone);
  $utc_time_zone = new DateTimeZone('UTC');
  $date_time = new DateTime($local_datetime, $local_time_zone);
  $date_time->setTimezone($utc_time_zone);

  return $date_time->format($format);
}

/**
 * Convert a UTC datetime string to a local datetime string.
 *
 * @param string $utc_datetime Local datetime string.
 * @param string $local_time_zone The local time zone to convert from.
 *
 * @return string The local datetime string.
 */
function get_local_datetime($utc_datetime, $local_time_zone, $format = 'Y-m-d H:i:s') {
  $local_time_zone = new DateTimeZone($local_time_zone);
  $utc_time_zone = new DateTimeZone('UTC');
  $date_time = new DateTime($utc_datetime, $utc_time_zone);
  $date_time->setTimezone($local_time_zone);

  return $date_time->format($format);
}

/**
 * Encode data with base64url (RFC 4648 §5).
 *
 * @param string $data The data to encode.
 * @return string The base64url encoded string.
 */
function base64url_encode($data) {
  return rtrim(strtr(base64_encode($data), '+/', '-_'), '=');
}

/**
 * Decode a base64url encoded string (RFC 4648 §5).
 *
 * @param string $data The base64url encoded string.
 * @return string|false The decoded data or false on failure.
 */
function base64url_decode($data) {
  $b64 = strtr($data, '-_', '+/');
  return base64_decode(str_pad($b64, strlen($b64) % 4 === 0 ? strlen($b64) : strlen($b64) + 4 - strlen($b64) % 4, '=', STR_PAD_RIGHT));
}