|
|
@@ -5,10 +5,9 @@
|
|
|
*
|
|
|
* Portions of this file are under other licenses. This is noted where
|
|
|
* it is relevant.
|
|
|
-*********************************************************************************************************************/
|
|
|
+**********************************************************************************************************************/
|
|
|
|
|
|
-namespace {
|
|
|
-// == | Setup | =======================================================================================================
|
|
|
+namespace { // == | Setup and Global Constants | ======================================================================
|
|
|
|
|
|
// Check that we can run on this version of PHP
|
|
|
if (PHP_MAJOR_VERSION . PHP_MINOR_VERSION < '81') {
|
|
|
@@ -17,27 +16,18 @@ if (PHP_MAJOR_VERSION . PHP_MINOR_VERSION < '81') {
|
|
|
|
|
|
// --------------------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
+// Check for ROOT_PATH
|
|
|
+if (!defined('ROOT_PATH')) {
|
|
|
+ die('BinOC Metropolis Utilities: You MUST define ROOT_PATH.');
|
|
|
+}
|
|
|
+
|
|
|
// Do not allow this to be included more than once...
|
|
|
-if (defined('BINOC_UTILS')) {
|
|
|
+if (defined('kUtilities')) {
|
|
|
die('BinOC Metropolis Utilities: You may not include this file more than once.');
|
|
|
}
|
|
|
|
|
|
// Define that this is a thing which can double as a version check.
|
|
|
-define('BINOC_UTILS', '2.0.0a1');
|
|
|
-
|
|
|
-// --------------------------------------------------------------------------------------------------------------------
|
|
|
-
|
|
|
-if (!defined('kAppVendor')) {
|
|
|
- define('kAppVendor', 'Binary Outcast');
|
|
|
-}
|
|
|
-
|
|
|
-if (!defined('kAppName')) {
|
|
|
- define('kAppName', 'Metropolis-based Software');
|
|
|
-}
|
|
|
-
|
|
|
-if (!defined('kAppVersion')) {
|
|
|
- define('kAppVersion', BINOC_UTILS);
|
|
|
-}
|
|
|
+define('kUtilities', '2.0.0a1');
|
|
|
|
|
|
// --------------------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
@@ -53,13 +43,6 @@ const E_EXCEPTION = 65536;
|
|
|
|
|
|
// --------------------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
-// Debug flag (CLI always triggers debug mode)
|
|
|
-define('kDebugMode', $_GET['debug'] ?? SAPI_IS_CLI);
|
|
|
-
|
|
|
-// ====================================================================================================================
|
|
|
-
|
|
|
-// == | Global Constants | ============================================================================================
|
|
|
-
|
|
|
// Define basic symbol constants
|
|
|
const NEW_LINE = "\n";
|
|
|
const EMPTY_STRING = "";
|
|
|
@@ -74,15 +57,39 @@ const PIPE = "|";
|
|
|
const AMP = "&";
|
|
|
const DOLLAR = "\$";
|
|
|
const COLON = ":";
|
|
|
-const SCOPE = COLON . COLON;
|
|
|
+const SCOPE_OPERATOR = COLON . COLON;
|
|
|
+const RESOLUTION_OPERATOR = '->';
|
|
|
const DOTDOT = DOT . DOT;
|
|
|
const DASH_SEPARATOR = SPACE . DASH . SPACE;
|
|
|
const SCHEME_SUFFIX = COLON . SLASH . SLASH;
|
|
|
|
|
|
// ------------------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
-const FILE_WRITE_FLAGS = "w+";
|
|
|
-const FILE_EXTS = array(
|
|
|
+if (!defined('kAppVendor')) {
|
|
|
+ define('kAppVendor', 'Binary Outcast');
|
|
|
+}
|
|
|
+
|
|
|
+if (!defined('kAppName')) {
|
|
|
+ define('kAppName', 'Metropolis-based Software');
|
|
|
+}
|
|
|
+
|
|
|
+if (!defined('kAppVersion')) {
|
|
|
+ define('kAppVersion', kUtilities);
|
|
|
+}
|
|
|
+
|
|
|
+if (!defined('kAppRepository')) {
|
|
|
+ define('kAppRepository', '#');
|
|
|
+}
|
|
|
+
|
|
|
+// --------------------------------------------------------------------------------------------------------------------
|
|
|
+
|
|
|
+// Debug flag (CLI always triggers debug mode)
|
|
|
+define('kDebugMode', $_GET['debug'] ?? SAPI_IS_CLI);
|
|
|
+
|
|
|
+// --------------------------------------------------------------------------------------------------------------------
|
|
|
+
|
|
|
+const kFileWriteFlags = "w+";
|
|
|
+const kFileExt = array(
|
|
|
'php' => DOT . 'php',
|
|
|
'ini' => DOT . 'ini',
|
|
|
'html' => DOT . 'html',
|
|
|
@@ -114,18 +121,18 @@ const FILE_EXTS = array(
|
|
|
|
|
|
// ------------------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
-const XML_TAG = '<?xml version="1.0" encoding="utf-8" ?>';
|
|
|
+const kXmlTag = '<?xml version="1.0" encoding="utf-8" ?>';
|
|
|
|
|
|
// ------------------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
-const JSON_FLAGS = array(
|
|
|
+const kJsonFlags = array(
|
|
|
'display' => JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE,
|
|
|
'storage' => JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE,
|
|
|
);
|
|
|
|
|
|
// ------------------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
-const REGEX_PATTERNS = array(
|
|
|
+const kRegexPatterns = array(
|
|
|
'query' => "/[^-a-zA-Z0-9_\-\/\{\}\@\.\%\s\,]/",
|
|
|
'yaml' => "/\A---(.|\n)*?---/",
|
|
|
'guid' => "/^\{[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\}$/i",
|
|
|
@@ -141,1179 +148,1562 @@ const APRMD5_ALPHABET = './0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijk
|
|
|
|
|
|
// ------------------------------------------------------------------------------------------------------------------
|
|
|
|
|
|
-const DEFAULT_HOME_TEXT = 'Site Root (Home)';
|
|
|
+const kDefaultSkinName = 'default';
|
|
|
+const kDefaultSkinPath = '/base/skin';
|
|
|
+const kDefaultMenu = ['/' => 'Front Page (Home)'];
|
|
|
+const kSpecialComponent = 'special';
|
|
|
+const kSpecialComponentName = 'Special Component';
|
|
|
|
|
|
// XXX: Remove these!
|
|
|
-const PHP_EXTENSION = FILE_EXTS['php'];
|
|
|
-const JSON_EXTENSION = FILE_EXTS['json'];
|
|
|
+const PHP_EXTENSION = kFileExt['php'];
|
|
|
+const JSON_EXTENSION = kFileExt['json'];
|
|
|
const PALEMOON_GUID = '{8de7fcbb-c55c-4fbe-bfc5-fc555c87dbc4}';
|
|
|
-const REGEX_GET_FILTER = REGEX_PATTERNS['query'];
|
|
|
-const JSON_ENCODE_FLAGS = JSON_FLAGS['display'];
|
|
|
+const REGEX_GET_FILTER = kRegexPatterns['query'];
|
|
|
+const JSON_ENCODE_FLAGS = kJsonFlags['display'];
|
|
|
|
|
|
// ====================================================================================================================
|
|
|
-}
|
|
|
|
|
|
-namespace mozilla\vc {
|
|
|
-// == | nsIVersionComparator | ========================================================================================
|
|
|
+// == | Static Registry Class | =======================================================================================
|
|
|
|
|
|
-/**
|
|
|
-* Implements Mozilla Toolkit's nsIVersionComparator
|
|
|
-*
|
|
|
-* Version strings are dot-separated sequences of version-parts.
|
|
|
-*
|
|
|
-* A version-part consists of up to four parts, all of which are optional:
|
|
|
-* <number-a><string-b><number-c><string-d (everything else)>
|
|
|
-* A version-part may also consist of a single asterisk "*" which indicates
|
|
|
-* "infinity".
|
|
|
-*
|
|
|
-* Numbers are base-10, and are zero if left out.
|
|
|
-* Strings are compared bytewise.
|
|
|
-*
|
|
|
-* For additional backwards compatibility, if "string-b" is "+" then
|
|
|
-* "number-a" is incremented by 1 and "string-b" becomes "pre".
|
|
|
-*
|
|
|
-* 1.0pre1
|
|
|
-* < 1.0pre2
|
|
|
-* < 1.0 == 1.0.0 == 1.0.0.0
|
|
|
-* < 1.1pre == 1.1pre0 == 1.0+
|
|
|
-* < 1.1pre1a
|
|
|
-* < 1.1pre1
|
|
|
-* < 1.1pre10a
|
|
|
-* < 1.1pre10
|
|
|
-*
|
|
|
-* Although not required by this interface, it is recommended that
|
|
|
-* numbers remain within the limits of a signed char, i.e. -127 to 128.
|
|
|
-*/
|
|
|
-class ToolkitVersionPart {
|
|
|
- public $numA = 0;
|
|
|
- public $strB = null;
|
|
|
- public $numC = 0;
|
|
|
- public $extraD = null;
|
|
|
-}
|
|
|
+// Define a global array to hold the registry
|
|
|
+$gRuntime = [];
|
|
|
|
|
|
-class ToolkitVersionComparator {
|
|
|
- public static function compare($a, $b) {
|
|
|
- do {
|
|
|
- $va = new ToolkitVersionPart();
|
|
|
- $vb = new ToolkitVersionPart();
|
|
|
- $a = self::parseVersionPart($a, $va);
|
|
|
- $b = self::parseVersionPart($b, $vb);
|
|
|
-
|
|
|
- $result = self::compareVersionPart($va, $vb);
|
|
|
-
|
|
|
- if ($result != 0){
|
|
|
- break;
|
|
|
- }
|
|
|
+class gRegistryUtils {
|
|
|
+ private static $sInited = false;
|
|
|
+ private static $sStore = EMPTY_ARRAY;
|
|
|
+ private static $sRemap = ['constant', 'superglobal'];
|
|
|
+
|
|
|
+ /********************************************************************************************************************
|
|
|
+ * Init the static class
|
|
|
+ ********************************************************************************************************************/
|
|
|
+ public static function init() {
|
|
|
+ if (self::$sInited) {
|
|
|
+ return;
|
|
|
}
|
|
|
|
|
|
- while ($a != null || $b != null);
|
|
|
+ $domain = function($aHost, $aReturnSub = false) {
|
|
|
+ $host = gExplodeStr(DOT, $aHost);
|
|
|
+ return implode(DOT, $aReturnSub ? array_slice($host, 0, -2) : array_slice($host, -2, 2));
|
|
|
+ };
|
|
|
|
|
|
- if ($result >= 1) { $result = 1; }
|
|
|
- if ($result <= -1) { $result = -1; }
|
|
|
+ $path = gExplodePath(self::SuperGlobal('get', 'path', SLASH));
|
|
|
|
|
|
- return $result;
|
|
|
+ self::$sStore = array(
|
|
|
+ 'app' => array(
|
|
|
+ 'component' => self::SuperGlobal('get', 'component', 'site'),
|
|
|
+ 'path' => $path,
|
|
|
+ 'depth' => count($path ?? EMPTY_ARRAY),
|
|
|
+ 'debug' => kDebugMode,
|
|
|
+ ),
|
|
|
+ 'network' => array(
|
|
|
+ 'scheme' => self::SuperGlobal('server', 'SCHEME') ?? (self::SuperGlobal('server', 'HTTPS') ? 'https' : 'http'),
|
|
|
+ 'baseDomain' => $domain(self::SuperGlobal('server', 'SERVER_NAME', 'localhost')),
|
|
|
+ 'subDomain' => $domain(self::SuperGlobal('server', 'SERVER_NAME', 'localhost'), true),
|
|
|
+ 'remoteAddr' => self::SuperGlobal('server', 'HTTP_X_FORWARDED_FOR', self::SuperGlobal('server', 'REMOTE_ADDR', '127.0.0.1')),
|
|
|
+ 'userAgent' => self::SuperGlobal('server', 'HTTP_USER_AGENT', 'php' . DASH . PHP_SAPI . SLASH . PHP_VERSION),
|
|
|
+ ),
|
|
|
+ 'console' => array(
|
|
|
+ 'output' => array(
|
|
|
+ 'skin' => 'default',
|
|
|
+ 'contentType' => ini_get('default_mimetype'),
|
|
|
+ ),
|
|
|
+ 'content' => array(
|
|
|
+ 'skin' => kDefaultSkinName,
|
|
|
+ 'skinPath' => kDefaultSkinPath,
|
|
|
+ 'template' => null,
|
|
|
+ 'stylesheet' => null,
|
|
|
+ 'mainmenu' => kDefaultMenu,
|
|
|
+ 'commandbar' => kDefaultMenu,
|
|
|
+ 'statustext' => 'Done',
|
|
|
+ ),
|
|
|
+ ),
|
|
|
+ );
|
|
|
+
|
|
|
+ if (defined('kDebugDomain') && !SAPI_IS_CLI) {
|
|
|
+ self::$sStore['app']['debug'] =
|
|
|
+ (self::SuperGlobal('server', 'SERVER_NAME', 'localhost') != constant('kDebugDomain') ?? EMPTY_STRING) ?
|
|
|
+ file_exists(gPath(ROOT_PATH, '.debugMode')) :
|
|
|
+ !kDebugMode;
|
|
|
+ }
|
|
|
+
|
|
|
+ self::$sInited = true;
|
|
|
}
|
|
|
-
|
|
|
-
|
|
|
- private static function parseVersionPart($aVersion, ToolkitVersionPart $result) {
|
|
|
- if ($aVersion === null || strlen($aVersion) == 0) {
|
|
|
- return $aVersion;
|
|
|
+
|
|
|
+ /********************************************************************************************************************
|
|
|
+ * Get the registry property and return it
|
|
|
+ ********************************************************************************************************************/
|
|
|
+ public static function Component(?string $aCompareComponent = null) {
|
|
|
+ $rv = (self::$sInited) ? self::get('app.component') : self::SuperGlobal('get', 'component', 'site');
|
|
|
+
|
|
|
+ if ($aCompareComponent) {
|
|
|
+ $rv = ($rv === $aCompareComponent);
|
|
|
}
|
|
|
-
|
|
|
- $tok = explode(".", trim($aVersion));
|
|
|
- $part = $tok[0];
|
|
|
-
|
|
|
- if ($part == "*") {
|
|
|
- $result->numA = PHP_INT_MAX;
|
|
|
- $result->strB = "";
|
|
|
+
|
|
|
+ return $rv;
|
|
|
+ }
|
|
|
+
|
|
|
+ /********************************************************************************************************************
|
|
|
+ * Get the registry property and return it
|
|
|
+ ********************************************************************************************************************/
|
|
|
+ public static function debug() {
|
|
|
+ return (self::$sInited) ? self::get('app.debug') : kDebugMode;
|
|
|
+ }
|
|
|
+
|
|
|
+ /********************************************************************************************************************
|
|
|
+ * Get the registry property and return it
|
|
|
+ ********************************************************************************************************************/
|
|
|
+ public static function getStore() {
|
|
|
+ return self::$sStore;
|
|
|
+ }
|
|
|
+
|
|
|
+ /********************************************************************************************************************
|
|
|
+ * Get the value of a dotted key from the registry property except for virtual regnodes
|
|
|
+ ********************************************************************************************************************/
|
|
|
+ public static function get(string $aKey, $aDefault = null) {
|
|
|
+ if ($aKey == EMPTY_STRING) {
|
|
|
+ return null;
|
|
|
}
|
|
|
- else {
|
|
|
- $vertok = new ToolkitVersionPartTokenizer($part);
|
|
|
- $next = $vertok->nextToken();
|
|
|
- if (is_numeric($next)){
|
|
|
- $result->numA = $next;
|
|
|
- }
|
|
|
- else {
|
|
|
- $result->numA = 0;
|
|
|
- }
|
|
|
-
|
|
|
- if ($vertok->hasMoreElements()) {
|
|
|
- $str = $vertok->nextToken();
|
|
|
- // if part is of type "<num>+"
|
|
|
- if ($str[0] == '+') {
|
|
|
- $result->numA++;
|
|
|
- $result->strB = "pre";
|
|
|
- }
|
|
|
- else {
|
|
|
- // else if part is of type "<num><alpha>..."
|
|
|
- $result->strB = $str;
|
|
|
-
|
|
|
- if ($vertok->hasMoreTokens()) {
|
|
|
- $next = $vertok->nextToken();
|
|
|
- if (is_numeric($next)){
|
|
|
- $result->numC = $next;
|
|
|
- }
|
|
|
- else {
|
|
|
- $result->numC = 0;
|
|
|
- }
|
|
|
- if ($vertok->hasMoreTokens()) {
|
|
|
- $result->extraD = $vertok->getRemainder();
|
|
|
- }
|
|
|
+
|
|
|
+ $keys = gExplodeStr(DOT, $aKey);
|
|
|
+
|
|
|
+ if (in_array($keys[0] ?? EMPTY_STRING, self::$sRemap)) {
|
|
|
+ switch ($keys[0] ?? EMPTY_STRING) {
|
|
|
+ case 'constant':
|
|
|
+ if (count($keys) < 2) {
|
|
|
+ return null;
|
|
|
}
|
|
|
- }
|
|
|
+
|
|
|
+ $ucConst = strtoupper($keys[1]);
|
|
|
+ $prefixConst = 'k' . ucfirst($keys[1]);
|
|
|
+
|
|
|
+ switch (true) {
|
|
|
+ case defined($prefixConst):
|
|
|
+ $rv = constant($prefixConst);
|
|
|
+ break;
|
|
|
+ case defined($ucConst):
|
|
|
+ $rv = constant($ucConst);
|
|
|
+ break;
|
|
|
+ case defined($keys[1]):
|
|
|
+ $rv = constant($keys[1]);
|
|
|
+ break;
|
|
|
+ default:
|
|
|
+ return null;
|
|
|
+ }
|
|
|
+
|
|
|
+ if (!\Illuminate\Support\Arr::accessible($rv)) {
|
|
|
+ return $rv ?? $aDefault;
|
|
|
+ }
|
|
|
+
|
|
|
+ unset($keys[0], $keys[1]);
|
|
|
+ $rv = \Illuminate\Support\Arr::get($rv, gMaybeNull(implode(DOT, $keys)), $aDefault);
|
|
|
+ break;
|
|
|
+ case 'superglobal':
|
|
|
+ if (count($keys) < 3) {
|
|
|
+ return null;
|
|
|
+ }
|
|
|
+
|
|
|
+ $rv = self::SuperGlobal($keys[1], $keys[2]);
|
|
|
+
|
|
|
+ if (!Illuminate\Support\Arr::accessible($rv)) {
|
|
|
+ return $rv ?? $aDefault;
|
|
|
+ }
|
|
|
+
|
|
|
+ unset($keys[0], $keys[1]);
|
|
|
+ $rv = \Illuminate\Support\Arr::get($rv, gMaybeNull(implode(DOT, $keys)), $aDefault);
|
|
|
+ break;
|
|
|
+ default:
|
|
|
+ if (count($keys) < 2 || str_starts_with($keys[1], UNDERSCORE)) {
|
|
|
+ return null;
|
|
|
+ }
|
|
|
+
|
|
|
+ unset($keys[0]);
|
|
|
+ $rv = \Illuminate\Support\Arr::get($GLOBALS, gMaybeNull(implode(DOT, $keys)), $aDefault);
|
|
|
}
|
|
|
}
|
|
|
+ else {
|
|
|
+ $rv = \Illuminate\Support\Arr::get(self::$sStore, $aKey, $aDefault);
|
|
|
+ }
|
|
|
+
|
|
|
+ return $rv;
|
|
|
+ }
|
|
|
|
|
|
- if (sizeOf($tok)>1) {
|
|
|
- // return everything after "."
|
|
|
- return substr($aVersion, strlen($part) + 1);
|
|
|
+ /********************************************************************************************************************
|
|
|
+ * Set the value of a dotted key from the registry property
|
|
|
+ ********************************************************************************************************************/
|
|
|
+ public static function set(string $aKey, string|int|bool|array|null $aValue) {
|
|
|
+ if (in_array(gExplodeStr(DOT, $aKey)[0] ?? EMPTY_STRING, self::$sRemap)) {
|
|
|
+ gError('Setting values on virtual nodes is not supported.');
|
|
|
}
|
|
|
|
|
|
- return null;
|
|
|
+ return \Illuminate\Support\Arr::set(self::$sStore, $aKey, $aValue);
|
|
|
}
|
|
|
-
|
|
|
-
|
|
|
- private static function compareVersionPart(ToolkitVersionPart $va, ToolkitVersionPart $vb) {
|
|
|
- $res = self::compareInt($va->numA, $vb->numA);
|
|
|
- if ($res != 0) { return $res; }
|
|
|
-
|
|
|
- $res = self::compareString($va->strB, $vb->strB);
|
|
|
- if ($res != 0) { return $res; }
|
|
|
-
|
|
|
- $res = self::compareInt($va->numC, $vb->numC);
|
|
|
- if ($res != 0) { return $res; }
|
|
|
+
|
|
|
+ /********************************************************************************************************************
|
|
|
+ * Access Super Globals
|
|
|
+ ********************************************************************************************************************/
|
|
|
+ public static function SuperGlobal($aNode, $aKey, $aDefault = null) {
|
|
|
+ $rv = null;
|
|
|
+
|
|
|
+ // Turn the variable type into all caps prefixed with an underscore
|
|
|
+ $aNode = UNDERSCORE . strtoupper($aNode);
|
|
|
+
|
|
|
+ // This handles the superglobals
|
|
|
+ switch($aNode) {
|
|
|
+ case '_CHECK':
|
|
|
+ $rv = gMaybeNull($aKey);
|
|
|
+ break;
|
|
|
+ case '_GET':
|
|
|
+ if (SAPI_IS_CLI && $GLOBALS['argc'] > 1) {
|
|
|
+ $args = [];
|
|
|
+
|
|
|
+ foreach (array_slice($GLOBALS['argv'], 1) as $_value) {
|
|
|
+ $arg = @explode('=', $_value);
|
|
|
+
|
|
|
+ if (count($arg) < 2) {
|
|
|
+ continue;
|
|
|
+ }
|
|
|
+
|
|
|
+ $attr = str_replace('--', EMPTY_STRING, $arg[0]);
|
|
|
+ $val = gMaybeNull(str_replace('"', EMPTY_STRING, $arg[1]));
|
|
|
+
|
|
|
+ if (!$attr && !$val) {
|
|
|
+ continue;
|
|
|
+ }
|
|
|
+
|
|
|
+ $args[$attr] = $val;
|
|
|
+ }
|
|
|
+
|
|
|
+ $rv = $args[$aKey] ?? $aDefault;
|
|
|
+ break;
|
|
|
+ }
|
|
|
+ case '_SERVER':
|
|
|
+ case '_ENV':
|
|
|
+ case '_FILES':
|
|
|
+ case '_POST':
|
|
|
+ case '_COOKIE':
|
|
|
+ case '_SESSION':
|
|
|
+ $rv = $GLOBALS[$aNode][$aKey] ?? $aDefault;
|
|
|
+ break;
|
|
|
+ default:
|
|
|
+ // We don't know WHAT was requested but it is obviously wrong...
|
|
|
+ gError('Unknown system node.');
|
|
|
+ }
|
|
|
|
|
|
- return self::compareString($va->extraD, $vb->extraD);
|
|
|
- }
|
|
|
-
|
|
|
-
|
|
|
- private static function compareInt($n1, $n2) { return $n1 - $n2; }
|
|
|
-
|
|
|
-
|
|
|
- private static function compareString($str1, $str2) {
|
|
|
- // any string is *before* no string
|
|
|
- if ($str1 === null) { return ($str2 !== null) ? 1 : 0; }
|
|
|
- if ($str2 === null) { return -1; }
|
|
|
- return strcmp($str1, $str2);
|
|
|
- }
|
|
|
-}
|
|
|
+ // We always pass $_GET values through a general regular expression
|
|
|
+ // This allows only a-z A-Z 0-9 - / { } @ % whitespace and ,
|
|
|
+ if ($rv && $aNode == "_GET") {
|
|
|
+ $rv = preg_replace(REGEX_GET_FILTER, EMPTY_STRING, $rv);
|
|
|
+ }
|
|
|
|
|
|
-/**
|
|
|
- * Specialized tokenizer for Mozilla version strings. A token can
|
|
|
- * consist of one of the four sections of a version string:
|
|
|
- * <number-a><string-b><number-c><string-d (everything else)>
|
|
|
- */
|
|
|
-class ToolkitVersionPartTokenizer {
|
|
|
- private $part = '';
|
|
|
-
|
|
|
- public function __construct($aPart) { $this->part = $aPart; }
|
|
|
-
|
|
|
- public function hasMoreElements() { return strlen($this->part) != 0; }
|
|
|
- public function hasMoreTokens() { return strlen($this->part) != 0; }
|
|
|
- public function nextToken() { return $this->nextElement(); }
|
|
|
-
|
|
|
- public function nextElement() {
|
|
|
- if (preg_match('/^[\+\-]?[0-9].*/', $this->part)) {
|
|
|
- // if string starts with a number...
|
|
|
- $index = 0;
|
|
|
- if ($this->part[0] == '+' || $this->part[0] == '-') {
|
|
|
- $index = 1;
|
|
|
- }
|
|
|
- while (($index < strlen($this->part)) && is_numeric($this->part[$index])) {
|
|
|
- $index++;
|
|
|
+ // Files need special handling.. In principle we hard fail if it is anything other than
|
|
|
+ // OK or NO FILE
|
|
|
+ if ($rv && $aNode == "_FILES") {
|
|
|
+ if (!in_array($rv['error'], [UPLOAD_ERR_OK, UPLOAD_ERR_NO_FILE])) {
|
|
|
+ gError('Upload of ' . $aKey . ' failed with error code: ' . $rv['error']);
|
|
|
}
|
|
|
- $numPart = substr($this->part, 0, $index);
|
|
|
- $this->part = substr($this->part, $index);
|
|
|
- return $numPart;
|
|
|
- }
|
|
|
- else {
|
|
|
- // ... or if this is the non-numeric part of version string
|
|
|
- $index = 0;
|
|
|
- while (($index < strlen($this->part)) && !is_numeric($this->part[$index])) {
|
|
|
- $index++;
|
|
|
+
|
|
|
+ // No file is handled as merely being null
|
|
|
+ if ($rv['error'] == UPLOAD_ERR_NO_FILE) {
|
|
|
+ return null;
|
|
|
}
|
|
|
- $alphaPart = substr($this->part, 0, $index);
|
|
|
- $this->part = substr($this->part, $index);
|
|
|
- return $alphaPart;
|
|
|
+
|
|
|
+ // Cursory check the actual mime-type and replace whatever the web client sent
|
|
|
+ $rv['type'] = mime_content_type($rv['tmp_name']);
|
|
|
}
|
|
|
+
|
|
|
+ return $rv;
|
|
|
}
|
|
|
-
|
|
|
- /**
|
|
|
- * Returns what remains of the original string, without tokenization. This
|
|
|
- * method is useful for getting the <string-d (everything else)>;
|
|
|
- * section of a version string.
|
|
|
- *
|
|
|
- * @return remaining version string
|
|
|
- */
|
|
|
- public function getRemainder() { return $this->part; }
|
|
|
}
|
|
|
|
|
|
// ====================================================================================================================
|
|
|
-}
|
|
|
-
|
|
|
-namespace Illuminate\Support {
|
|
|
-// == | ArrayUtils | ==================================================================================================
|
|
|
-
|
|
|
-/* The Arr class and its methods are under the following license:
|
|
|
-
|
|
|
- The MIT License (MIT)
|
|
|
-
|
|
|
- Copyright (c) Taylor Otwell
|
|
|
|
|
|
- Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
|
|
|
- documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
|
|
|
- rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
|
|
|
- persons to whom the Software is furnished to do so, subject to the following conditions:
|
|
|
+// == | Static Error Class | ==========================================================================================
|
|
|
|
|
|
- The above copyright notice and this permission notice shall be included in all copies or substantial portions
|
|
|
- of the Software.
|
|
|
+class gErrorUtils {
|
|
|
+ const kPhpErrorCodes = array(
|
|
|
+ E_ERROR => 'PHP Error',
|
|
|
+ E_WARNING => 'PHP Warning',
|
|
|
+ E_PARSE => 'PHP Error (Parser)',
|
|
|
+ E_NOTICE => 'PHP Notice',
|
|
|
+ E_CORE_ERROR => 'PHP Error (Core)',
|
|
|
+ E_CORE_WARNING => 'PHP Warning (Core)',
|
|
|
+ E_COMPILE_ERROR => 'PHP Error (Compiler)',
|
|
|
+ E_COMPILE_WARNING => 'PHP Warning (Compiler)',
|
|
|
+ E_USER_ERROR => 'PHP Error (Application)',
|
|
|
+ E_USER_WARNING => 'PHP Warning (Application)',
|
|
|
+ E_USER_NOTICE => 'PHP Notice (Application)',
|
|
|
+ E_STRICT => 'PHP Error (Strict)',
|
|
|
+ E_RECOVERABLE_ERROR => 'PHP Error (Recoverable)',
|
|
|
+ E_DEPRECATED => 'PHP Deprecation',
|
|
|
+ E_USER_DEPRECATED => 'PHP Deprecation (Application)',
|
|
|
+ E_ALL => 'Unable to Comply',
|
|
|
+ E_EXCEPTION => 'PHP Exception',
|
|
|
+ );
|
|
|
|
|
|
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
|
|
|
- WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
|
|
- COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
|
|
|
- OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
-*/
|
|
|
-class Arr {
|
|
|
- /**
|
|
|
- * Get an item from an array using "dot" notation.
|
|
|
- *
|
|
|
- * @param \ArrayAccess|array $array
|
|
|
- * @param string|int|null $key
|
|
|
- * @param mixed $default
|
|
|
- * @return mixed
|
|
|
- */
|
|
|
- public static function get($array, $key, $default = null)
|
|
|
- {
|
|
|
- if (! static::accessible($array)) {
|
|
|
- return value($default);
|
|
|
- }
|
|
|
+ public static function init() {
|
|
|
+ return;
|
|
|
+ }
|
|
|
+}
|
|
|
|
|
|
- if (is_null($key)) {
|
|
|
- return $array;
|
|
|
- }
|
|
|
+// ====================================================================================================================
|
|
|
|
|
|
- if (static::exists($array, $key)) {
|
|
|
- return $array[$key];
|
|
|
- }
|
|
|
+// == | Static Output Class | =========================================================================================
|
|
|
|
|
|
- if (! str_contains($key, '.')) {
|
|
|
- return $array[$key] ?? value($default);
|
|
|
- }
|
|
|
+class gConsoleUtils {
|
|
|
+ const HTTP_HEADERS = array(
|
|
|
+ 404 => 'HTTP/1.1 404 Not Found',
|
|
|
+ 501 => 'HTTP/1.1 501 Not Implemented',
|
|
|
+ 'text' => 'Content-Type: text/plain',
|
|
|
+ 'html' => 'Content-Type: text/html',
|
|
|
+ 'xhtml' => 'Content-Type: application/xhtml+xml',
|
|
|
+ 'css' => 'Content-Type: text/css',
|
|
|
+ 'xml' => 'Content-Type: text/xml',
|
|
|
+ 'json' => 'Content-Type: application/json',
|
|
|
+ 'bin' => 'Content-Type: application/octet-stream',
|
|
|
+ 'xpi' => 'Content-Type: application/x-xpinstall',
|
|
|
+ '7z' => 'Content-Type: application/x-7z-compressed',
|
|
|
+ 'xz' => 'Content-Type: application/x-xz',
|
|
|
+ );
|
|
|
|
|
|
- foreach (explode('.', $key) as $segment) {
|
|
|
- if (static::accessible($array) && static::exists($array, $segment)) {
|
|
|
- $array = $array[$segment];
|
|
|
- } else {
|
|
|
- return value($default);
|
|
|
- }
|
|
|
- }
|
|
|
+ /**********************************************************************************************************************
|
|
|
+ * Sends HTTP Headers to client using a short name
|
|
|
+ *
|
|
|
+ * @dep HTTP_HEADERS
|
|
|
+ * @dep kDebugMode
|
|
|
+ * @dep gError()
|
|
|
+ * @param $aHeader Short name of header
|
|
|
+ **********************************************************************************************************************/
|
|
|
+ public static function header($aHeader, $aReplace = true) {
|
|
|
+ $debugMode = gRegistryUtils::debug();
|
|
|
+ $isErrorPage = in_array($aHeader, [404, 501]);
|
|
|
|
|
|
- return $array;
|
|
|
+ if (!array_key_exists($aHeader, self::HTTP_HEADERS)) {
|
|
|
+ gError('Unknown' . SPACE . $aHeader . SPACE . 'header');
|
|
|
}
|
|
|
|
|
|
- /**
|
|
|
- * Determine whether the given value is array accessible.
|
|
|
- *
|
|
|
- * @param mixed $value
|
|
|
- * @return bool
|
|
|
- */
|
|
|
- public static function accessible($value)
|
|
|
- {
|
|
|
- return is_array($value) || $value instanceof ArrayAccess;
|
|
|
+ if ($debugMode && $isErrorPage) {
|
|
|
+ gError(self::HTTP_HEADERS[$aHeader]);
|
|
|
}
|
|
|
|
|
|
- /**
|
|
|
- * Determine if the given key exists in the provided array.
|
|
|
- *
|
|
|
- * @param \ArrayAccess|array $array
|
|
|
- * @param string|int $key
|
|
|
- * @return bool
|
|
|
- */
|
|
|
- public static function exists($array, $key)
|
|
|
- {
|
|
|
- if ($array instanceof ArrayAccess) {
|
|
|
- return $array->offsetExists($key);
|
|
|
- }
|
|
|
- return array_key_exists($key, $array);
|
|
|
- }
|
|
|
+ if (!headers_sent()) {
|
|
|
+ header(self::HTTP_HEADERS[$aHeader], $aReplace);
|
|
|
|
|
|
- /**
|
|
|
- * Return the default value of the given value.
|
|
|
- *
|
|
|
- * @param mixed $value
|
|
|
- * @return mixed
|
|
|
- */
|
|
|
- public static function value($value)
|
|
|
- {
|
|
|
- return $value instanceof Closure ? $value() : $value;
|
|
|
+ if ($isErrorPage) {
|
|
|
+ exit();
|
|
|
+ }
|
|
|
}
|
|
|
+ }
|
|
|
|
|
|
- /**
|
|
|
- * Set an array item to a given value using "dot" notation.
|
|
|
- *
|
|
|
- * If no key is given to the method, the entire array will be replaced.
|
|
|
- *
|
|
|
- * @param array $array
|
|
|
- * @param string|int|null $key
|
|
|
- * @param mixed $value
|
|
|
- * @return array
|
|
|
- */
|
|
|
- public static function set(&$array, $key, $value)
|
|
|
- {
|
|
|
- if (is_null($key)) {
|
|
|
- return $array = $value;
|
|
|
- }
|
|
|
-
|
|
|
- $keys = explode('.', $key);
|
|
|
-
|
|
|
- foreach ($keys as $i => $key) {
|
|
|
- if (count($keys) === 1) {
|
|
|
- break;
|
|
|
- }
|
|
|
-
|
|
|
- unset($keys[$i]);
|
|
|
+ /**********************************************************************************************************************
|
|
|
+ * Sends HTTP Header to redirect the client to another URL
|
|
|
+ *
|
|
|
+ * @param $aURL URL to redirect to
|
|
|
+ **********************************************************************************************************************/
|
|
|
+ public static function redirect($aURL) { header('Location: ' . $aURL, true, 302); exit(); }
|
|
|
|
|
|
- // If the key doesn't exist at this depth, we will just create an empty array
|
|
|
- // to hold the next value, allowing us to create the arrays to hold final
|
|
|
- // values at the correct depth. Then we'll keep digging into the array.
|
|
|
- if (! isset($array[$key]) || ! is_array($array[$key])) {
|
|
|
- $array[$key] = [];
|
|
|
- }
|
|
|
+ /**********************************************************************************************************************
|
|
|
+ * Get a subdomain or base domain from a host
|
|
|
+ *
|
|
|
+ * @dep DOT
|
|
|
+ * @dep gExplodeStr()
|
|
|
+ * @param $aHost Hostname
|
|
|
+ * @param $aReturnSub Should return subdmain
|
|
|
+ * @returns domain or subdomain
|
|
|
+ ***********************************************************************************************************************/
|
|
|
+ public static function getDomain(string $aHost, ?bool $aReturnSub = null) {
|
|
|
+ $host = gExplodeStr(DOT, $aHost);
|
|
|
+ return implode(DOT, $aReturnSub ? array_slice($host, 0, -2) : array_slice($host, -2, 2));
|
|
|
+ }
|
|
|
|
|
|
- $array = &$array[$key];
|
|
|
- }
|
|
|
+ /******************************************************************************************************************
|
|
|
+ * Simply prints output and sends header if not cli and exits
|
|
|
+ ******************************************************************************************************************/
|
|
|
+ public static function output($aContent, $aHeader = null) {
|
|
|
+ $content = null;
|
|
|
|
|
|
- $array[array_shift($keys)] = $value;
|
|
|
+ if (is_array($aContent)) {
|
|
|
+ $title = $aContent['title'] ?? 'Output';
|
|
|
+ $content = $aContent['content'] ?? EMPTY_STRING;
|
|
|
|
|
|
- return $array;
|
|
|
+ if ($title == 'Output' && $content == EMPTY_STRING) {
|
|
|
+ $content = $aContent ?? $content;
|
|
|
}
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ $title = 'Output';
|
|
|
+ $content = $aContent ?? EMPTY_STRING;
|
|
|
+ }
|
|
|
|
|
|
- /**
|
|
|
- * Remove one or many array items from a given array using "dot" notation.
|
|
|
- *
|
|
|
- * @param array $array
|
|
|
- * @param array|string|int|float $keys
|
|
|
- * @return void
|
|
|
- */
|
|
|
- public static function forget(&$array, $keys)
|
|
|
- {
|
|
|
- $original = &$array;
|
|
|
+ $content = (is_string($content) || is_int($content)) ? $content : json_encode($content, kJsonFlags['display']);
|
|
|
|
|
|
- $keys = (array) $keys;
|
|
|
+ // Send the header if not cli
|
|
|
+ if (SAPI_IS_CLI) {
|
|
|
+ if (!CLI_NO_LOGO) {
|
|
|
+ $software = $title . DASH_SEPARATOR . kAppVendor . SPACE . kAppName . SPACE . kAppVersion;
|
|
|
+ $titleLength = 120 - 8 - strlen($software);
|
|
|
+ $titleLength = ($titleLength > 0) ? $titleLength : 2;
|
|
|
+ $title = NEW_LINE . '==' . SPACE . PIPE . SPACE . $software . SPACE . PIPE . SPACE . str_repeat('=', $titleLength);
|
|
|
+ $content = $title . NEW_LINE . NEW_LINE . $content . NEW_LINE . NEW_LINE . str_repeat('=', 120) . NEW_LINE;
|
|
|
+ }
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ if (!headers_sent()) {
|
|
|
+ self::header($aHeader ?? 'text');
|
|
|
+ }
|
|
|
+ }
|
|
|
|
|
|
- if (count($keys) === 0) {
|
|
|
- return;
|
|
|
- }
|
|
|
+ // Write out the content
|
|
|
+ print($content);
|
|
|
|
|
|
- foreach ($keys as $key) {
|
|
|
- // if the exact key exists in the top-level, remove it
|
|
|
- if (static::exists($array, $key)) {
|
|
|
- unset($array[$key]);
|
|
|
+ // We're done here...
|
|
|
+ exit();
|
|
|
+ }
|
|
|
|
|
|
- continue;
|
|
|
- }
|
|
|
+ /******************************************************************************************************************
|
|
|
+ * Basic Site Content Generation using a Special Template
|
|
|
+ ******************************************************************************************************************/
|
|
|
+ public static function content(mixed $aContent, array $aMetadata = EMPTY_ARRAY) {
|
|
|
+ $template = SAPI_IS_CLI ? false : gReadFile(gPath(ROOT_PATH, 'base', 'skin', 'template.xhtml'));
|
|
|
+ $stylesheet = SAPI_IS_CLI ? false : gReadFile(gPath(ROOT_PATH, 'base', 'skin', 'stylesheet.css'));
|
|
|
|
|
|
- $parts = explode('.', $key);
|
|
|
+ if (!$template) {
|
|
|
+ gOutput(['content' => $aContent, 'title' => $aMetadata['title'] ?? 'Output']);
|
|
|
+ }
|
|
|
|
|
|
- // clean up before each pass
|
|
|
- $array = &$original;
|
|
|
+ $content = $aContent;
|
|
|
|
|
|
- while (count($parts) > 1) {
|
|
|
- $part = array_shift($parts);
|
|
|
+ $metadata = function($val) use(&$aMetadata) {
|
|
|
+ return $aMetadata[$val] ?? null;
|
|
|
+ };
|
|
|
|
|
|
- if (isset($array[$part]) && static::accessible($array[$part])) {
|
|
|
- $array = &$array[$part];
|
|
|
- } else {
|
|
|
- continue 2;
|
|
|
- }
|
|
|
- }
|
|
|
+ $menuize = function($aMenu) {
|
|
|
+ $rv = EMPTY_STRING;
|
|
|
|
|
|
- unset($array[array_shift($parts)]);
|
|
|
+ foreach ($aMenu as $_key => $_value) {
|
|
|
+ if (gContains($_key, 'onclick=', 1)) {
|
|
|
+ $rv .= '<li><a href="#"' . SPACE . $_key . '>' . $_value . '</a></li>';
|
|
|
}
|
|
|
- }
|
|
|
-
|
|
|
- /**
|
|
|
- * Flatten a multi-dimensional associative array with dots.
|
|
|
- *
|
|
|
- * @param iterable $array
|
|
|
- * @param string $prepend
|
|
|
- * @return array
|
|
|
- */
|
|
|
- public static function dot($array, $prepend = '')
|
|
|
- {
|
|
|
- $results = [];
|
|
|
-
|
|
|
- foreach ($array as $key => $value) {
|
|
|
- if (is_array($value) && ! empty($value)) {
|
|
|
- $results = array_merge($results, static::dot($value, $prepend.$key.'.'));
|
|
|
- } else {
|
|
|
- $results[$prepend.$key] = $value;
|
|
|
- }
|
|
|
+ else {
|
|
|
+ $rv .= '<li><a href="' . $_key . '">' . $_value . '</a></li>';
|
|
|
}
|
|
|
+ }
|
|
|
|
|
|
- return $results;
|
|
|
- }
|
|
|
-
|
|
|
- /**
|
|
|
- * Convert a flatten "dot" notation array into an expanded array.
|
|
|
- *
|
|
|
- * @param iterable $array
|
|
|
- * @return array
|
|
|
- */
|
|
|
- public static function undot($array)
|
|
|
- {
|
|
|
- $results = [];
|
|
|
-
|
|
|
- foreach ($array as $key => $value) {
|
|
|
- static::set($results, $key, $value);
|
|
|
- }
|
|
|
+ return $rv;
|
|
|
+ };
|
|
|
|
|
|
- return $results;
|
|
|
+ if ((is_string($content) || is_int($content)) && !$metadata('textbox') && !$metadata('iframe')) {
|
|
|
+ if (!gContains($content, ['<p', '<ul', '<ol', '<h1', '<h2', '<h3', '<table'])) {
|
|
|
+ $content = '<p>' . $content . '</p>';
|
|
|
+ }
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ $aMetadata['textbox'] = true;
|
|
|
}
|
|
|
-}
|
|
|
-
|
|
|
-// ====================================================================================================================
|
|
|
-}
|
|
|
|
|
|
-namespace {
|
|
|
-// == | Static Registry Class | =======================================================================================
|
|
|
+ if ($metadata('textbox')) {
|
|
|
+ $content = (is_string($content) || is_int($content)) ? $content : json_encode($content, kJsonFlags['display']);
|
|
|
+ $content = '<form><textarea class="special-textbox" name="content" rows="30" readonly>' . $content . '</textarea></form>';
|
|
|
+ }
|
|
|
|
|
|
-class gRegistryUtils {
|
|
|
- private static $init = false;
|
|
|
- private static $registry = EMPTY_ARRAY;
|
|
|
- private static $remap = ['static', 'general', 'request'];
|
|
|
+ $siteName = gRegistry('console.content.siteName', kAppName);
|
|
|
+ $sectionName = gRegistry('console.content.sectionName', EMPTY_STRING);
|
|
|
|
|
|
- /********************************************************************************************************************
|
|
|
- * Init the static class
|
|
|
- ********************************************************************************************************************/
|
|
|
- public static function init() {
|
|
|
- if (self::$init) {
|
|
|
- return;
|
|
|
+ if ($sectionName) {
|
|
|
+ $siteName = $sectionName . DASH_SEPARATOR . $siteName;
|
|
|
}
|
|
|
|
|
|
- $domain = function($aHost, $aReturnSub = false) {
|
|
|
- $host = gSplitString(DOT, $aHost);
|
|
|
- return implode(DOT, $aReturnSub ? array_slice($host, 0, -2) : array_slice($host, -2, 2));
|
|
|
- };
|
|
|
-
|
|
|
- $path = gSplitPath(self::getGlobalVar('get', 'path', SLASH));
|
|
|
- self::$registry = array(
|
|
|
- 'app' => array(
|
|
|
- 'component' => self::getGlobalVar('get', 'component', 'site'),
|
|
|
- 'path' => $path,
|
|
|
- 'depth' => count($path ?? EMPTY_ARRAY),
|
|
|
- 'debug' => kDebugMode,
|
|
|
- ),
|
|
|
- 'network' => array(
|
|
|
- 'scheme' => self::getGlobalVar('server', 'SCHEME') ?? (self::getGlobalVar('server', 'HTTPS') ? 'https' : 'http'),
|
|
|
- 'baseDomain' => $domain(self::getGlobalVar('server', 'SERVER_NAME', 'localhost')),
|
|
|
- 'subDomain' => $domain(self::getGlobalVar('server', 'SERVER_NAME', 'localhost'), true),
|
|
|
- 'remoteAddr' => self::getGlobalVar('server', 'HTTP_X_FORWARDED_FOR', self::getGlobalVar('server', 'REMOTE_ADDR', '127.0.0.1')),
|
|
|
- 'userAgent' => self::getGlobalVar('server', 'HTTP_USER_AGENT', 'php' . DASH . PHP_SAPI . SLASH . PHP_VERSION),
|
|
|
- ),
|
|
|
- 'output' => array(
|
|
|
- 'skin' => 'default',
|
|
|
- 'contentType' => ini_get('default_mimetype'),
|
|
|
- ),
|
|
|
+ $isTestCase = (!$metadata('title') && gRegistry('special.testCase') && gRegistry('app.component') == kSpecialComponent);
|
|
|
+
|
|
|
+ $substs = array(
|
|
|
+ '{$SITE_STYLESHEET}' => $stylesheet ?? EMPTY_STRING,
|
|
|
+ '{$PAGE_CONTENT}' => $content,
|
|
|
+ '{$SITE_NAME}' => $siteName,
|
|
|
+ '{$SITE_MENU}' => $menuize(gRegistry('console.content.commandbar')),
|
|
|
+ '{$SITE_SECTION}' => $sectionName ?? EMPTY_STRING,
|
|
|
+ '{$PAGE_TITLE}' => $isTestCase ? '[Test]' . SPACE . gRegistry('special.testCase') : ($metadata('title') ?? 'Output'),
|
|
|
+ '{$PAGE_STATUS}' => $metadata('statustext') ?? gRegistry('console.content.statustext'),
|
|
|
+ '{$SKIN_PATH}' => gPath(SLASH, 'base', 'skin'),
|
|
|
+ '{$SOFTWARE_VENDOR}' => kAppVendor,
|
|
|
+ '{$SOFTWARE_NAME}' => kAppName,
|
|
|
+ '{$SOFTWARE_VERSION}' => kAppVersion,
|
|
|
);
|
|
|
|
|
|
- self::$init = true;
|
|
|
+ $content = gSubst($template, $substs);
|
|
|
+
|
|
|
+ ob_end_clean();
|
|
|
+ gOutput($content, 'html');
|
|
|
}
|
|
|
|
|
|
- /********************************************************************************************************************
|
|
|
- * Get the registry property and return it
|
|
|
- ********************************************************************************************************************/
|
|
|
- public static function component(?string $aCompareComponent = null) {
|
|
|
- $rv = (self::$init) ? self::get('app.component') : self::getGlobalVar('get', 'component', 'site');
|
|
|
+ /**********************************************************************************************************************
|
|
|
+ * Special Component!
|
|
|
+ ***********************************************************************************************************************/
|
|
|
+ public static function specialComponent() {
|
|
|
+ $spCurrentPath = gRegistry('app.path');
|
|
|
+ $spPathCount = gRegistry('app.depth');
|
|
|
|
|
|
- if ($aCompareComp) {
|
|
|
- $rv = ($rv === $aCompareComponent);
|
|
|
+ if ($spCurrentPath[0] != kSpecialComponent) {
|
|
|
+ gRedirect(SLASH . kSpecialComponent . SLASH);
|
|
|
}
|
|
|
|
|
|
- return $rv;
|
|
|
- }
|
|
|
+ if (gRegistry('constant.disableSpecialComponent')) {
|
|
|
+ gNotFound('The Special Component has been disabled.');
|
|
|
+ }
|
|
|
|
|
|
- /********************************************************************************************************************
|
|
|
- * Get the registry property and return it
|
|
|
- ********************************************************************************************************************/
|
|
|
- public static function debug() {
|
|
|
- return (self::$init) ? self::get('app.debug') : kDebugMode;
|
|
|
- }
|
|
|
+ gRegistrySet('app.component', kSpecialComponent);
|
|
|
+ gRegistrySet('console.content.sectionName', kSpecialComponentName);
|
|
|
|
|
|
- /********************************************************************************************************************
|
|
|
- * Get the registry property and return it
|
|
|
- ********************************************************************************************************************/
|
|
|
- public static function getStore() {
|
|
|
- $store = self::$registry;
|
|
|
-
|
|
|
- /*
|
|
|
- $store['static'] = get_defined_constants(true)['user'] ?? EMPTY_ARRAY;
|
|
|
-
|
|
|
- $store['request'] = array(
|
|
|
- 'get' => SAPI_IS_CLI ? $_ARGV : $_GET,
|
|
|
- 'server' => $_SERVER ?? EMPTY_ARRAY,
|
|
|
- 'files' => $_FILES ?? EMPTY_ARRAY,
|
|
|
- 'post' => $_POST ?? EMPTY_ARRAY,
|
|
|
- 'cookie' => $_COOKIE ?? EMPTY_ARRAY,
|
|
|
- 'session' => $_SESSION ?? EMPTY_ARRAY,
|
|
|
+ // The Special Component never has more than one level below it
|
|
|
+ // We still have to determine the root of the component though...
|
|
|
+ if ($spPathCount == 1) {
|
|
|
+ // URL /special/
|
|
|
+ $spSpecialFunction = 'root';
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ // URL /special/xxx/
|
|
|
+ if ($spPathCount > 2) {
|
|
|
+ gNotFound('The special component only has one path level.');
|
|
|
+ }
|
|
|
+ $spSpecialFunction = $spCurrentPath[1];
|
|
|
+ }
|
|
|
+
|
|
|
+ $spCommandBar = array(
|
|
|
+ '/special/' => kSpecialComponentName,
|
|
|
+ '/special/test/' => 'Test Cases',
|
|
|
+ '/special/vc/' => 'Version Compare',
|
|
|
+ '/special/guid/' => 'GUID',
|
|
|
+ '/special/hex/' => 'Hex String',
|
|
|
+ '/special/runtime/' => 'Runtime Status',
|
|
|
);
|
|
|
- */
|
|
|
|
|
|
- return $store;
|
|
|
- }
|
|
|
+ gRegistrySet('console.content.commandbar', gRegistry('constant.components.site') ?
|
|
|
+ array_merge(kDefaultMenu, $spCommandBar) :
|
|
|
+ $spCommandBar);
|
|
|
|
|
|
- /********************************************************************************************************************
|
|
|
- * Get the value of a dotted key from the registry property except for virtual regnodes
|
|
|
- ********************************************************************************************************************/
|
|
|
- public static function get(string $aKey, $aDefault = null) {
|
|
|
- if ($aKey == EMPTY_STRING) {
|
|
|
- return null;
|
|
|
- }
|
|
|
+ unset($spCurrentPath, $spPathCount, $spCommandBar);
|
|
|
|
|
|
- $keys = gSplitStr(DOT, $aKey);
|
|
|
+ switch ($spSpecialFunction) {
|
|
|
+ case 'root':
|
|
|
+ $spContent = '<h2>Welcome</h2>' .
|
|
|
+ '<p>Please select a special function from the command bar above.';
|
|
|
+ gContent($spContent, ['title' => 'Overview']);
|
|
|
+ break;
|
|
|
+ case 'test':
|
|
|
+ $spCase = gRegistry('superglobal.get.case');
|
|
|
+ $spTestsPath = gPath(ROOT_PATH, 'base', 'tests');
|
|
|
+ $spGlobTests = glob(gPath($spTestsPath, WILDCARD . PHP_EXTENSION));
|
|
|
+ $spTests = EMPTY_ARRAY;
|
|
|
+
|
|
|
+ foreach ($spGlobTests as $_value) {
|
|
|
+ $spTests[] = gSubst($_value, [PHP_EXTENSION => EMPTY_STRING, $spTestsPath . SLASH => EMPTY_STRING]);
|
|
|
+ }
|
|
|
|
|
|
- if (in_array($keys[0] ?? EMPTY_STRING, self::$remap)) {
|
|
|
- switch ($keys[0] ?? EMPTY_STRING) {
|
|
|
- case 'static':
|
|
|
- if (count($keys) < 2) {
|
|
|
- return null;
|
|
|
+ if ($spCase) {
|
|
|
+ if (!gContains($spCase, $spTests)) {
|
|
|
+ gError('Unknown test case.');
|
|
|
}
|
|
|
|
|
|
- $ucConst = strtoupper($keys[1]);
|
|
|
- $prefixConst = 'k' . ucfirst($keys[1]);
|
|
|
+ gRegistrySet('special.testCase', $spCase);
|
|
|
+ require_once(gPath($spTestsPath, $spCase . PHP_EXTENSION));
|
|
|
+ headers_sent() ? exit() : gError('The operation completed successfully.');
|
|
|
+ }
|
|
|
|
|
|
- switch (true) {
|
|
|
- case defined($prefixConst):
|
|
|
- $rv = constant($prefixConst);
|
|
|
- break;
|
|
|
- case defined($ucConst):
|
|
|
- $rv = constant($ucConst);
|
|
|
- break;
|
|
|
- case defined($keys[1]):
|
|
|
- $rv = constant($keys[1]);
|
|
|
- break;
|
|
|
- default:
|
|
|
- return null;
|
|
|
- }
|
|
|
+ $spContent = EMPTY_STRING;
|
|
|
|
|
|
- if (!\Illuminate\Support\Arr::accessible($rv)) {
|
|
|
- return $rv ?? $aDefault;
|
|
|
- }
|
|
|
+ foreach ($spTests as $_value) {
|
|
|
+ $spContent .= '<li><a href="/special/test/?case=' . $_value . '">' . $_value . '</a></li>';
|
|
|
+ }
|
|
|
|
|
|
- unset($keys[0], $keys[1]);
|
|
|
- $rv = \Illuminate\Support\Arr::get($rv, self::getGlobalVar('check', implode(DOT, $keys)), $aDefault);
|
|
|
- break;
|
|
|
- case 'request':
|
|
|
- if (count($keys) < 3) {
|
|
|
- return null;
|
|
|
- }
|
|
|
+ $spContent = ($spContent == EMPTY_STRING) ?
|
|
|
+ '<p>There are no test cases.</p>' :
|
|
|
+ '<h2>Please select a test case…</h2><ul>' . $spContent . '</ul>' . str_repeat('<br />', 3);
|
|
|
|
|
|
- $rv = self::getGlobalVar($keys[1], $keys[2]);
|
|
|
+ gContent($spContent, ['title' => 'Test Cases']);
|
|
|
+ break;
|
|
|
+ case 'vc':
|
|
|
+ $spCurrVer = gRegistry('superglobal.post.currVer');
|
|
|
+ $spCompVer = gRegistry('superglobal.post.compVer');
|
|
|
|
|
|
- if (!Illuminate\Support\Arr::accessible($rv)) {
|
|
|
- return $rv ?? $aDefault;
|
|
|
- }
|
|
|
+ if ($spCurrVer && $spCompVer) {
|
|
|
+ gContent(gVersionCompare($spCurrVer, $spCompVer));
|
|
|
+ }
|
|
|
|
|
|
- unset($keys[0], $keys[1]);
|
|
|
- $rv = \Illuminate\Support\Arr::get($rv, self::getGlobalVar('check', implode(DOT, $keys)), $aDefault);
|
|
|
- break;
|
|
|
- default:
|
|
|
- if (count($keys) < 2 || str_starts_with($keys[1], UNDERSCORE)) {
|
|
|
- return null;
|
|
|
- }
|
|
|
+ $spForm = '<form action="/special/vc/" method="post">Current Version:<br/><input type="text" name="currVer"><br/><br/>' .
|
|
|
+ 'Compare to Version:<br/><input type="text" name="compVer"><br/><br/><input type="submit"></form>';
|
|
|
|
|
|
- unset($keys[0]);
|
|
|
- $rv = \Illuminate\Support\Arr::get($GLOBALS, self::getGlobalVar('check', implode(DOT, $keys)), $aDefault);
|
|
|
- }
|
|
|
- }
|
|
|
- else {
|
|
|
- $rv = \Illuminate\Support\Arr::get(self::$registry, $aKey, $aDefault);
|
|
|
- }
|
|
|
-
|
|
|
- return $rv;
|
|
|
- }
|
|
|
-
|
|
|
- /********************************************************************************************************************
|
|
|
- * Set the value of a dotted key from the registry property
|
|
|
- ********************************************************************************************************************/
|
|
|
- public static function set($aKey, $aValue) {
|
|
|
- if (in_array(gSplitStr(DOT, $aKey)[0] ?? EMPTY_STRING, self::$remap)) {
|
|
|
- gError('Setting values on remapped nodes is not supported.');
|
|
|
- }
|
|
|
-
|
|
|
- if ($aValue instanceof \Closure) {
|
|
|
- return false;
|
|
|
+ gContent('<h2>nsIVersionComparator</h2>' . $spForm, ['title' => 'Runtime Status']);
|
|
|
+ break;
|
|
|
+ case 'guid':
|
|
|
+ gContent(gGlobalIdentifer(gRegistry('superglobal.get.vendor'), true), ['title' => 'Globally Unique Identifier (In XPIDL Notation)', 'textbox' => true]);
|
|
|
+ break;
|
|
|
+ case 'hex':
|
|
|
+ gContent(gHexString(gRegistry('superglobal.get.length', 40)), ['title' => 'Pseudo-Random Hex String', 'textbox' => true]);
|
|
|
+ break;
|
|
|
+ case 'runtime':
|
|
|
+ gContent(gRegistryUtils::getStore(), ['title' => 'Runtime Status']);
|
|
|
+ break;
|
|
|
+ case 'system':
|
|
|
+ ini_set('default_mimetype', 'text/html');
|
|
|
+ phpinfo(INFO_GENERAL | INFO_CONFIGURATION | INFO_ENVIRONMENT | INFO_VARIABLES);
|
|
|
+ break;
|
|
|
+ default:
|
|
|
+ gNotFound('There is no matching case in the special component main switch.');
|
|
|
}
|
|
|
|
|
|
- return \Illuminate\Support\Arr::set(self::$registry, $aKey, $aValue);
|
|
|
+ // We're done here
|
|
|
+ exit();
|
|
|
}
|
|
|
|
|
|
- /********************************************************************************************************************
|
|
|
- * Access Super Globals
|
|
|
- ********************************************************************************************************************/
|
|
|
- public static function getGlobalVar($aNode, $aKey, $aDefault = null) {
|
|
|
- $rv = null;
|
|
|
-
|
|
|
- // Turn the variable type into all caps prefixed with an underscore
|
|
|
- $aNode = UNDERSCORE . strtoupper($aNode);
|
|
|
-
|
|
|
- // This handles the superglobals
|
|
|
- switch($aNode) {
|
|
|
- case '_CHECK':
|
|
|
- $rv = (empty($aKey) || $aKey === 'none' || $aKey === 0) ? null : $aKey;
|
|
|
- break;
|
|
|
- case '_GET':
|
|
|
- if (SAPI_IS_CLI && $GLOBALS['argc'] > 1) {
|
|
|
- $args = [];
|
|
|
-
|
|
|
- foreach (array_slice($GLOBALS['argv'], 1) as $_value) {
|
|
|
- $arg = @explode('=', $_value);
|
|
|
-
|
|
|
- if (count($arg) < 2) {
|
|
|
- continue;
|
|
|
- }
|
|
|
+ /**********************************************************************************************************************
|
|
|
+ * Create an XML Document
|
|
|
+ ***********************************************************************************************************************/
|
|
|
+ public static function extensibleMarkup(string|array $aData, ?bool $aDirectOutput = null) {
|
|
|
+ if (is_string($aData)) {
|
|
|
+ $xml = $aData;
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ $dom = new DOMDocument('1.0');
|
|
|
+ $dom->encoding = "UTF-8";
|
|
|
+ $dom->formatOutput = true;
|
|
|
|
|
|
- $attr = str_replace('--', EMPTY_STRING, $arg[0]);
|
|
|
- $val = self::getGlobalVar('check', str_replace('"', EMPTY_STRING, $arg[1]));
|
|
|
+ $processChildren = function($aData) use (&$dom, &$processChildren) {
|
|
|
+ if (!($aData['@elem'] ?? null)) {
|
|
|
+ return false;
|
|
|
+ }
|
|
|
|
|
|
- if (!$attr && !$val) {
|
|
|
- continue;
|
|
|
- }
|
|
|
+ // Create the element
|
|
|
+ $element = $dom->createElement($aData['@elem']);
|
|
|
|
|
|
- $args[$attr] = $val;
|
|
|
+ // Properly handle content using XML and not try and be lazy.. It almost never works!
|
|
|
+ if (array_key_exists('@content', $aData) && is_string($aData['@content'])) {
|
|
|
+ if (gContains($aData['@content'], ["<", ">", "?", "&", "'", "\""])) {
|
|
|
+ $content = $dom->createCDATASection($aData['@content'] ?? EMPTY_STRING);
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ $content = $dom->createTextNode($aData['@content'] ?? EMPTY_STRING);
|
|
|
}
|
|
|
|
|
|
- $rv = $args[$aKey] ?? $aDefault;
|
|
|
- break;
|
|
|
+ $element->appendChild($content);
|
|
|
}
|
|
|
- case '_SERVER':
|
|
|
- case '_ENV':
|
|
|
- case '_FILES':
|
|
|
- case '_POST':
|
|
|
- case '_COOKIE':
|
|
|
- case '_SESSION':
|
|
|
- $rv = $GLOBALS[$aNode][$aKey] ?? $aDefault;
|
|
|
- break;
|
|
|
- default:
|
|
|
- // We don't know WHAT was requested but it is obviously wrong...
|
|
|
- gError('Unknown system node.');
|
|
|
- }
|
|
|
-
|
|
|
- // We always pass $_GET values through a general regular expression
|
|
|
- // This allows only a-z A-Z 0-9 - / { } @ % whitespace and ,
|
|
|
- if ($rv && $aNode == "_GET") {
|
|
|
- $rv = preg_replace(REGEX_GET_FILTER, EMPTY_STRING, $rv);
|
|
|
- }
|
|
|
+
|
|
|
+ // Add any attributes
|
|
|
+ if (!empty($aData['@attr']) && is_array($aData['@attr'])) {
|
|
|
+ foreach ($aData['@attr'] as $_key => $_value) {
|
|
|
+ $element->setAttribute($_key, $_value);
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ // Any other items in the data array should be child elements
|
|
|
+ foreach ($aData as $_key => $_value) {
|
|
|
+ if (!is_numeric($_key)) {
|
|
|
+ continue;
|
|
|
+ }
|
|
|
+
|
|
|
+ $child = $processChildren($_value);
|
|
|
+ if ($child) {
|
|
|
+ $element->appendChild($child);
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ return $element;
|
|
|
+ };
|
|
|
|
|
|
- // Files need special handling.. In principle we hard fail if it is anything other than
|
|
|
- // OK or NO FILE
|
|
|
- if ($rv && $aNode == "_FILES") {
|
|
|
- if (!in_array($rv['error'], [UPLOAD_ERR_OK, UPLOAD_ERR_NO_FILE])) {
|
|
|
- gError('Upload of ' . $aKey . ' failed with error code: ' . $rv['error']);
|
|
|
+ $child = $processChildren($aData);
|
|
|
+ $xml = null;
|
|
|
+
|
|
|
+ if ($child) {
|
|
|
+ $dom->appendChild($child);
|
|
|
}
|
|
|
|
|
|
- // No file is handled as merely being null
|
|
|
- if ($rv['error'] == UPLOAD_ERR_NO_FILE) {
|
|
|
- return null;
|
|
|
+ $xml = $dom->saveXML();
|
|
|
+
|
|
|
+ if (!$xml) {
|
|
|
+ gError('Could not generate extensible markup.');
|
|
|
}
|
|
|
+ }
|
|
|
|
|
|
- // Cursory check the actual mime-type and replace whatever the web client sent
|
|
|
- $rv['type'] = mime_content_type($rv['tmp_name']);
|
|
|
+ if ($aDirectOutput) {
|
|
|
+ gOutput($xml, 'xml');
|
|
|
}
|
|
|
-
|
|
|
- return $rv;
|
|
|
+
|
|
|
+ return $xml;
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// ====================================================================================================================
|
|
|
|
|
|
-// == | Static Error Class | ==========================================================================================
|
|
|
+// == | Static Class Init and Global Wrappers | =======================================================================
|
|
|
+
|
|
|
+gRegistryUtils::init();
|
|
|
+//gErrorUtils::init();
|
|
|
+
|
|
|
+// --------------------------------------------------------------------------------------------------------------------
|
|
|
+
|
|
|
+function gRegistry(...$args) { return gRegistryUtils::get(...$args); }
|
|
|
+function gRegistrySet(...$args) { return gRegistryUtils::set(...$args); }
|
|
|
+
|
|
|
+// --------------------------------------------------------------------------------------------------------------------
|
|
|
+
|
|
|
+function gHeader(...$args) { return gConsoleUtils::header(...$args); }
|
|
|
+function gRedirect(...$args) { return gConsoleUtils::redirect(...$args); }
|
|
|
+function gContent(...$args) { return gConsoleUtils::content(...$args); }
|
|
|
+function gOutput(...$args) { return gConsoleUtils::output(...$args); }
|
|
|
|
|
|
+// --------------------------------------------------------------------------------------------------------------------
|
|
|
+
|
|
|
+function gVersionCompare(...$args) { return mozilla\vc\ToolkitVersionComparator::compare(...$args); }
|
|
|
|
|
|
+function gGetArrVal(...$args) { return Illuminate\Support\Arr::get(...$args); }
|
|
|
+function gSetArrVal(...$args) { return Illuminate\Support\Arr::set(...$args); }
|
|
|
+function gDelArrVal(...$args) { return Illuminate\Support\Arr::forget(...$args); }
|
|
|
+function gDotArray(...$args) { return Illuminate\Support\Arr::dot(...$args); }
|
|
|
+function gUndotArray(...$args) { return Illuminate\Support\Arr::undot(...$args); }
|
|
|
|
|
|
// ====================================================================================================================
|
|
|
|
|
|
-// == | Static Output Class | =========================================================================================
|
|
|
+// == | Global Functions | ============================================================================================
|
|
|
|
|
|
-class gConsole {
|
|
|
- const HTTP_HEADERS = array(
|
|
|
- 404 => 'HTTP/1.1 404 Not Found',
|
|
|
- 501 => 'HTTP/1.1 501 Not Implemented',
|
|
|
- 'text' => 'Content-Type: text/plain',
|
|
|
- 'html' => 'Content-Type: text/html',
|
|
|
- 'xhtml' => 'Content-Type: application/xhtml+xml',
|
|
|
- 'css' => 'Content-Type: text/css',
|
|
|
- 'xml' => 'Content-Type: text/xml',
|
|
|
- 'json' => 'Content-Type: application/json',
|
|
|
- 'bin' => 'Content-Type: application/octet-stream',
|
|
|
- 'xpi' => 'Content-Type: application/x-xpinstall',
|
|
|
- '7z' => 'Content-Type: application/x-7z-compressed',
|
|
|
- 'xz' => 'Content-Type: application/x-xz',
|
|
|
- );
|
|
|
+/**********************************************************************************************************************
|
|
|
+* General Error Function
|
|
|
+*
|
|
|
+* @param $aMessage Error message
|
|
|
+**********************************************************************************************************************/
|
|
|
+function gError(string $aMessage) {
|
|
|
+ gOutput($aMessage);
|
|
|
+}
|
|
|
|
|
|
- /**********************************************************************************************************************
|
|
|
- * Sends HTTP Headers to client using a short name
|
|
|
- *
|
|
|
- * @dep HTTP_HEADERS
|
|
|
- * @dep kDebugMode
|
|
|
- * @dep gError()
|
|
|
- * @param $aHeader Short name of header
|
|
|
- **********************************************************************************************************************/
|
|
|
- public static function header($aHeader, $aReplace = true) {
|
|
|
- $debugMode = gRegistryUtils::debug();
|
|
|
- $isErrorPage = in_array($aHeader, [404, 501]);
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Sends 404 or prints error message if debug mode
|
|
|
+**********************************************************************************************************************/
|
|
|
+function gNotFound(string $aMessage) {
|
|
|
+ gOutput($aMessage . NEW_LINE . 'Also, 404.');
|
|
|
+}
|
|
|
|
|
|
- if (!array_key_exists($aHeader, self::HTTP_HEADERS)) {
|
|
|
- gError('Unknown' . SPACE . $aHeader . SPACE . 'header');
|
|
|
- }
|
|
|
+function gMaybeNull($aValue) {
|
|
|
+ return (empty($aValue) || $aValue === 'none' || $aValue === 0) ? null : $aValue;
|
|
|
+}
|
|
|
|
|
|
- if ($debugMode && $isErrorPage) {
|
|
|
- gError(self::HTTP_HEADERS[$aHeader]);
|
|
|
- }
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Registers Files to be included such as components and modules
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gRegisterIncludes($aConst, $aIncludes) {
|
|
|
+ $aConst = strtoupper($aConst);
|
|
|
|
|
|
- if (!headers_sent()) {
|
|
|
- header(self::HTTP_HEADERS[$aHeader], $aReplace);
|
|
|
+ if (defined($aConst)) {
|
|
|
+ gError($aConst . SPACE . 'files are already registered and may not be updated.');
|
|
|
+ }
|
|
|
|
|
|
- if ($isErrorPage) {
|
|
|
- exit();
|
|
|
- }
|
|
|
+ $includes = EMPTY_ARRAY;
|
|
|
+
|
|
|
+ foreach($aIncludes as $_key => $_value) {
|
|
|
+ switch ($aConst) {
|
|
|
+ case 'COMPONENTS':
|
|
|
+ $includes[$_value] = gPath(ROOT_PATH, 'components', $_value, 'src', $_value . kFileExt['php']);
|
|
|
+ break;
|
|
|
+ case 'MODULES':
|
|
|
+ $includes[$_value] = gPath(ROOT_PATH, 'modules', $_value . kFileExt['php']);
|
|
|
+ break;
|
|
|
+ case 'LIBRARIES':
|
|
|
+ if (str_contains($_value, DOT . DOT)) {
|
|
|
+ return;
|
|
|
+ }
|
|
|
+
|
|
|
+ $includes[$_key] = gPath(ROOT_PATH, 'third_party', $_value);
|
|
|
+ break;
|
|
|
+ default:
|
|
|
+ gfError('Unknown include type');
|
|
|
}
|
|
|
}
|
|
|
|
|
|
- /**********************************************************************************************************************
|
|
|
- * Sends HTTP Header to redirect the client to another URL
|
|
|
- *
|
|
|
- * @param $aURL URL to redirect to
|
|
|
- **********************************************************************************************************************/
|
|
|
- public static function redirect($aURL) { header('Location: ' . $aURL, true, 302); exit(); }
|
|
|
+ define($aConst, $includes);
|
|
|
+}
|
|
|
|
|
|
- /**********************************************************************************************************************
|
|
|
- * Get a subdomain or base domain from a host
|
|
|
- *
|
|
|
- * @dep DOT
|
|
|
- * @dep gSplitString()
|
|
|
- * @param $aHost Hostname
|
|
|
- * @param $aReturnSub Should return subdmain
|
|
|
- * @returns domain or subdomain
|
|
|
- ***********************************************************************************************************************/
|
|
|
- public static function getDomain(string $aHost, ?bool $aReturnSub = null) {
|
|
|
- $host = gSplitString(DOT, $aHost);
|
|
|
- return implode(DOT, $aReturnSub ? array_slice($host, 0, -2) : array_slice($host, -2, 2));
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Registers Files to be included such as components and modules
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gLoadComponent() {
|
|
|
+ if (gRegistryUtils::Component(kSpecialComponent) || !gRegistry('constant.components.site')) {
|
|
|
+ gConsoleUtils::SpecialComponent();
|
|
|
}
|
|
|
+}
|
|
|
|
|
|
- /******************************************************************************************************************
|
|
|
- * Simply prints output and sends header if not cli and exits
|
|
|
- ******************************************************************************************************************/
|
|
|
- public static function display($aContent, $aHeader = null) {
|
|
|
- $content = null;
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Basic Filter Substitution of a string
|
|
|
+*
|
|
|
+* @dep EMPTY_STRING
|
|
|
+* @dep SLASH
|
|
|
+* @dep SPACE
|
|
|
+* @dep gError()
|
|
|
+* @param $aSubsts multi-dimensional array of keys and values to be replaced
|
|
|
+* @param $aString string to operate on
|
|
|
+* @param $aRegEx set to true if pcre
|
|
|
+* @returns bitwise int value representing applications
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gSubst(string $aString, array $aSubsts, bool $aRegEx = false) {
|
|
|
+ $rv = $aString;
|
|
|
+ $replaceFunction = $aRegEx ? 'preg_replace' : 'str_replace';
|
|
|
|
|
|
- if (is_array($aContent)) {
|
|
|
- $title = $aContent['title'] ?? 'Output';
|
|
|
- $content = $aContent['content'] ?? EMPTY_STRING;
|
|
|
+ foreach ($aSubsts as $_key => $_value) {
|
|
|
+ $rv = call_user_func($replaceFunction, ($aRegEx ? SLASH . $_key . SLASH . 'iU' : $_key), $_value, $rv);
|
|
|
+ }
|
|
|
|
|
|
- if ($title == 'Output' && $content == EMPTY_STRING) {
|
|
|
- $content = $aContent ?? $content;
|
|
|
+ return !$rv ? gError('Something has gone wrong...') : $rv;
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Determines if needle is in haystack and optionally where
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gContains(string|array $aHaystack, string|array $aNeedle, int $aPos = 0) {
|
|
|
+ $rv = false;
|
|
|
+ if (is_string($aNeedle)) {
|
|
|
+ $aNeedle = [$aNeedle];
|
|
|
+ }
|
|
|
+
|
|
|
+ foreach ($aNeedle as $_value) {
|
|
|
+ if (is_array($aHaystack)) {
|
|
|
+ $rv = ($aPos === 1) ? array_key_exists($_value, $aHaystack) : in_array($_value, $aHaystack);
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ switch ($aPos) {
|
|
|
+ case 1:
|
|
|
+ $rv = str_starts_with($aHaystack, $_value);
|
|
|
+ break;
|
|
|
+ case -1:
|
|
|
+ $rv = str_ends_with($aHaystack, $_value);
|
|
|
+ break;
|
|
|
+ case 0:
|
|
|
+ default:
|
|
|
+ $rv = str_contains($aHaystack, $_value);
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ if ($rv) {
|
|
|
+ break;
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ return $rv;
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Explodes a string to an array without empty elements if it starts or ends with the separator
|
|
|
+*
|
|
|
+* @dep DASH_SEPARATOR
|
|
|
+* @dep gError()
|
|
|
+* @param $aSeparator Separator used to split the string
|
|
|
+* @param $aString String to be exploded
|
|
|
+* @returns Array of string parts
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gExplodeStr(string $aSeparator, string $aString) {
|
|
|
+ return (!str_contains($aString, $aSeparator)) ? [$aString] :
|
|
|
+ array_values(array_filter(explode($aSeparator, $aString), 'strlen'));
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Splits a path into an indexed array of parts
|
|
|
+*
|
|
|
+* @dep SLASH
|
|
|
+* @dep gExplodeStr()
|
|
|
+* @param $aPath URI Path
|
|
|
+* @returns array of uri parts in order
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gExplodePath(string $aPath) {
|
|
|
+ return ($aPath == SLASH) ? ['root'] : gExplodeStr(SLASH, $aPath);
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Builds and Normalizes Paths
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gPath(...$aParts) {
|
|
|
+ $parts = EMPTY_ARRAY;
|
|
|
+ $path = strtr(implode(SLASH, $aParts), '\\', SLASH);
|
|
|
+ $prefix = EMPTY_STRING;
|
|
|
+ $absolute = false;
|
|
|
+
|
|
|
+ // extract a prefix being a protocol://, protocol:, protocol://drive: or simply drive:
|
|
|
+ if (preg_match('{^( [0-9a-z]{2,}+: (?: // (?: [a-z]: )? )? | [a-z]: )}ix', $path, $match)) {
|
|
|
+ $prefix = $match[1];
|
|
|
+ $path = substr($path, strlen($prefix));
|
|
|
+ }
|
|
|
+
|
|
|
+ if (substr($path, 0, 1) === SLASH) {
|
|
|
+ $absolute = true;
|
|
|
+ $path = substr($path, 1);
|
|
|
+ }
|
|
|
+
|
|
|
+ $up = false;
|
|
|
+
|
|
|
+ foreach (explode(SLASH, $path) as $chunk) {
|
|
|
+ if (DOTDOT === $chunk && ($absolute || $up)) {
|
|
|
+ array_pop($parts);
|
|
|
+ $up = !(empty($parts) || DOTDOT === end($parts));
|
|
|
+ }
|
|
|
+ elseif (DOT !== $chunk && EMPTY_STRING !== $chunk) {
|
|
|
+ $parts[] = $chunk;
|
|
|
+ $up = DOTDOT !== $chunk;
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ return $prefix . ($absolute ? SLASH : EMPTY_STRING) . implode(SLASH, $parts);
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Strips a string from another string
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gStripStr (string $aStr, string $aStrip = EMPTY_STRING) {
|
|
|
+ return str_replace($aStrip, EMPTY_STRING, $aStr);
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Read a file
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gReadFile(string $aFile) {
|
|
|
+ $rv = @file_get_contents($aFile);
|
|
|
+ return gMaybeNull($rv);
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Hash a password
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gPasswordHash(string $aPassword, mixed $aCrypt = PASSWORD_BCRYPT, ?string $aSalt = null) {
|
|
|
+ switch ($aCrypt) {
|
|
|
+ case PASSWORD_CLEARTEXT:
|
|
|
+ // We can "hash" a cleartext password by prefixing it with the fake algo prefix $clear$
|
|
|
+ if (str_contains($aPassword, DOLLAR)) {
|
|
|
+ // Since the dollar sign is used as an identifier and/or separator for hashes we can't use passwords
|
|
|
+ // that contain said dollar sign.
|
|
|
+ gError('Cannot "hash" this Clear Text password because it contains a dollar sign.');
|
|
|
+ }
|
|
|
+
|
|
|
+ return DOLLAR . PASSWORD_CLEARTEXT . DOLLAR . time() . DOLLAR . $aPassword;
|
|
|
+ case PASSWORD_HTACCESS:
|
|
|
+ // We want to be able to generate Apache APR1-MD5 hashes for use in .htpasswd situations.
|
|
|
+ $salt = $aSalt;
|
|
|
+
|
|
|
+ if (!$salt) {
|
|
|
+ $salt = EMPTY_STRING;
|
|
|
+
|
|
|
+ for ($i = 0; $i < 8; $i++) {
|
|
|
+ $offset = hexdec(bin2hex(openssl_random_pseudo_bytes(1))) % 64;
|
|
|
+ $salt .= APRMD5_ALPHABET[$offset];
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ $salt = substr($salt, 0, 8);
|
|
|
+ $max = strlen($aPassword);
|
|
|
+ $context = $aPassword . DOLLAR . PASSWORD_HTACCESS . DOLLAR . $salt;
|
|
|
+ $binary = pack('H32', md5($aPassword . $salt . $aPassword));
|
|
|
+
|
|
|
+ for ($i = $max; $i > 0; $i -= 16) {
|
|
|
+ $context .= substr($binary, 0, min(16, $i));
|
|
|
+ }
|
|
|
+
|
|
|
+ for ($i = $max; $i > 0; $i >>= 1) {
|
|
|
+ $context .= ($i & 1) ? chr(0) : $aPassword[0];
|
|
|
+ }
|
|
|
+
|
|
|
+ $binary = pack('H32', md5($context));
|
|
|
+
|
|
|
+ for ($i = 0; $i < 1000; $i++) {
|
|
|
+ $new = ($i & 1) ? $aPassword : $binary;
|
|
|
+
|
|
|
+ if ($i % 3) {
|
|
|
+ $new .= $salt;
|
|
|
+ }
|
|
|
+ if ($i % 7) {
|
|
|
+ $new .= $aPassword;
|
|
|
+ }
|
|
|
+
|
|
|
+ $new .= ($i & 1) ? $binary : $aPassword;
|
|
|
+ $binary = pack('H32', md5($new));
|
|
|
+ }
|
|
|
+
|
|
|
+ $hash = EMPTY_STRING;
|
|
|
+
|
|
|
+ for ($i = 0; $i < 5; $i++) {
|
|
|
+ $k = $i + 6;
|
|
|
+ $j = $i + 12;
|
|
|
+ if($j == 16) $j = 5;
|
|
|
+ $hash = $binary[$i] . $binary[$k] . $binary[$j] . $hash;
|
|
|
+ }
|
|
|
+
|
|
|
+ $hash = chr(0) . chr(0) . $binary[11] . $hash;
|
|
|
+ $hash = strtr(strrev(substr(base64_encode($hash), 2)), BASE64_ALPHABET, APRMD5_ALPHABET);
|
|
|
+
|
|
|
+ return DOLLAR . PASSWORD_HTACCESS . DOLLAR . $salt . DOLLAR . $hash;
|
|
|
+ default:
|
|
|
+ // Else, our standard (and secure) default is PASSWORD_BCRYPT hashing.
|
|
|
+ // We do not allow custom salts for anything using password_hash as PHP generates secure salts.
|
|
|
+ // PHP Generated passwords are also self-verifiable via password_verify.
|
|
|
+ return password_hash($aPassword, $aCrypt);
|
|
|
+ }
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Check a password
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gPasswordVerify(string $aPassword, string $aHash) {
|
|
|
+ // We can accept a pseudo-hash for clear text passwords in the format of $clrtxt$unix-epoch$clear-text-password
|
|
|
+ if (str_starts_with($aHash, DOLLAR . PASSWORD_CLEARTEXT)) {
|
|
|
+ $password = gExplodeStr(DOLLAR, $aHash) ?? null;
|
|
|
+
|
|
|
+ if ($password == null || count($password) > 3) {
|
|
|
+ gError('Unable to "verify" this Clear Text "hashed" password.');
|
|
|
+ }
|
|
|
+
|
|
|
+ return $aPassword === $password[2];
|
|
|
+ }
|
|
|
+
|
|
|
+ // We can also accept an Apache APR1-MD5 password that is commonly used in .htpasswd
|
|
|
+ if (str_starts_with($aHash, DOLLAR . PASSWORD_HTACCESS)) {
|
|
|
+ $salt = gExplodeStr(DOLLAR, $aHash)[1] ?? null;
|
|
|
+
|
|
|
+ if(!$salt) {
|
|
|
+ gError('Unable to verify this Apache APR1-MD5 hashed password.');
|
|
|
+ }
|
|
|
+
|
|
|
+ return gPasswordHash($aPassword, PASSWORD_HTACCESS, $salt) === $aHash;
|
|
|
+ }
|
|
|
+
|
|
|
+ // For everything else send to the native password_verify function.
|
|
|
+ // It is almost certain to be a BCRYPT2 hash but hashed passwords generated BY PHP are self-verifiable.
|
|
|
+ return password_verify($aPassword, $aHash);
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Generate a random hexadecimal string
|
|
|
+*
|
|
|
+* @param $aLength Desired number of final chars
|
|
|
+* @returns Random hexadecimal string of desired length
|
|
|
+**********************************************************************************************************************/
|
|
|
+function gHexString(int $aLength = 40) {
|
|
|
+ return bin2hex(random_bytes(($aLength <= 1) ? 1 : (int)($aLength / 2)));
|
|
|
+}
|
|
|
+
|
|
|
+/**********************************************************************************************************************
|
|
|
+* Generates a v4 random guid or a "v4bis" guid with static vendor node
|
|
|
+***********************************************************************************************************************/
|
|
|
+function gGlobalIdentifer(?string $aVendor = null, ?bool $aXPCOM = null) {
|
|
|
+ if ($aVendor) {
|
|
|
+ if (strlen($aVendor) < 3) {
|
|
|
+ gError('v4bis GUIDs require a defined vendor of more than three characters long.');
|
|
|
+ }
|
|
|
+
|
|
|
+ // Generate 8 pseudo-random bytes
|
|
|
+ $bytes = random_bytes(8);
|
|
|
+
|
|
|
+ // Knock the vendor down to lowercase so we can simply use a switch case
|
|
|
+ $vendor = strtolower($aVendor);
|
|
|
+
|
|
|
+ // We want "v4bis" GUIDs with the static vendor part to match the broken version of GUIDGenX for known nodes
|
|
|
+ // as Moonchild half-assed his tool that he wrote for this and by the time it was discovered several were already
|
|
|
+ // using the previous incorrect GUIDs.
|
|
|
+ $knownVendorNodes = array(
|
|
|
+ 'binoc' => hex2bin('8b97957ad5f8ea47'),
|
|
|
+ 'binoc-legacy' => hex2bin('9aa0aa0e607640b9'),
|
|
|
+ 'mcp' => hex2bin('bfc5fc555c87dbc4'),
|
|
|
+ 'lootyhoof' => hex2bin('b98e98e62085837f'),
|
|
|
+ 'pseudo-static' => hex2bin('93763763d1ad1978')
|
|
|
+ );
|
|
|
+
|
|
|
+ switch ($vendor) {
|
|
|
+ case 'binoc':
|
|
|
+ case 'binaryoutcast':
|
|
|
+ case 'binary outcast':
|
|
|
+ $bytes .= $knownVendorNodes['binoc'];
|
|
|
+ break;
|
|
|
+ case 'pseudo-static':
|
|
|
+ case 'pseudostatic':
|
|
|
+ case 'addons':
|
|
|
+ case 'add-ons':
|
|
|
+ case 'apmo':
|
|
|
+ $bytes .= $knownVendorNodes['pseudo-static'];
|
|
|
+ break;
|
|
|
+ case 'mcp':
|
|
|
+ case 'moonchildproductions':
|
|
|
+ case 'moonchild productions':
|
|
|
+ $bytes .= $knownVendorNodes['mcp'];
|
|
|
+ break;
|
|
|
+ case 'binoc-legacy':
|
|
|
+ case 'lootyhoof':
|
|
|
+ $bytes .= $knownVendorNodes[$vendor];
|
|
|
+ break;
|
|
|
+ default:
|
|
|
+ // Since this isn't a known busted vendor node then we should generate it ourselves.
|
|
|
+ // This matches the fixed version of GUIDGenX 1.1 which is to md5 hash the vendor string then
|
|
|
+ // split it in half and XOR the two parts for the final value
|
|
|
+ $vendor = hash('md5', $aVendor);
|
|
|
+ $bytes .= hex2bin(substr($vendor, 0, 16)) ^ hex2bin(substr($vendor, 16, 32));
|
|
|
+ }
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ // This is a pure v4 UUID spec which is 16 pseudo-random bytes.
|
|
|
+ $bytes = random_bytes(16);
|
|
|
+ }
|
|
|
+
|
|
|
+ // Set the version and variant
|
|
|
+ // NOTE: Like everything Moonzilla does, he did not set the variant value when he initially came up with "v4bis"
|
|
|
+ // putting a busted generator into production use for the whole team. Sad!
|
|
|
+ $bytes[6] = chr(ord($bytes[6]) & 0x0f | 0x40);
|
|
|
+ $bytes[8] = chr(ord($bytes[8]) & 0x3f | 0x80);
|
|
|
+
|
|
|
+ $hex = bin2hex($bytes);
|
|
|
+ $guid = vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split($hex, 4));
|
|
|
+
|
|
|
+ // We want the GUID in XPIDL/C++ Header notation
|
|
|
+ if ($aXPCOM) {
|
|
|
+ $explode = gExplodeStr(DASH, $guid);
|
|
|
+ $rv = "%{C++" . NEW_LINE . "//" . SPACE . "{" . $guid . "}" . NEW_LINE .
|
|
|
+ "#define NS_CHANGE_ME_IID" . SPACE .
|
|
|
+ vsprintf("{ 0x%s, 0x%s, 0x%s, { 0x%s, 0x%s, 0x%s, 0x%s, 0x%s, 0x%s, 0x%s, 0x%s } }",
|
|
|
+ [$explode[0], $explode[1], $explode[2],
|
|
|
+ substr($explode[3], 0, 2), substr($explode[3], 2, 2),
|
|
|
+ substr($explode[4], 0, 2), substr($explode[4], 2, 2), substr($explode[4], 4, 2),
|
|
|
+ substr($explode[4], 6, 2), substr($explode[4], 8, 2), substr($explode[4], 10, 2)]) . NEW_LINE .
|
|
|
+ "%}";
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ // We like Microsoft GUID notation not UUID which means Lisa needs braces.. I mean the GUID.
|
|
|
+ $rv = '{' . $guid . '}';
|
|
|
+ }
|
|
|
+
|
|
|
+ return $rv;
|
|
|
+}
|
|
|
+} // ==================================================================================================================
|
|
|
+
|
|
|
+namespace mozilla\vc { // == | nsIVersionComparator | =================================================================
|
|
|
+
|
|
|
+/**
|
|
|
+* Implements Mozilla Toolkit's nsIVersionComparator
|
|
|
+*
|
|
|
+* Version strings are dot-separated sequences of version-parts.
|
|
|
+*
|
|
|
+* A version-part consists of up to four parts, all of which are optional:
|
|
|
+* <number-a><string-b><number-c><string-d (everything else)>
|
|
|
+* A version-part may also consist of a single asterisk "*" which indicates
|
|
|
+* "infinity".
|
|
|
+*
|
|
|
+* Numbers are base-10, and are zero if left out.
|
|
|
+* Strings are compared bytewise.
|
|
|
+*
|
|
|
+* For additional backwards compatibility, if "string-b" is "+" then
|
|
|
+* "number-a" is incremented by 1 and "string-b" becomes "pre".
|
|
|
+*
|
|
|
+* 1.0pre1
|
|
|
+* < 1.0pre2
|
|
|
+* < 1.0 == 1.0.0 == 1.0.0.0
|
|
|
+* < 1.1pre == 1.1pre0 == 1.0+
|
|
|
+* < 1.1pre1a
|
|
|
+* < 1.1pre1
|
|
|
+* < 1.1pre10a
|
|
|
+* < 1.1pre10
|
|
|
+*
|
|
|
+* Although not required by this interface, it is recommended that
|
|
|
+* numbers remain within the limits of a signed char, i.e. -127 to 128.
|
|
|
+*/
|
|
|
+class ToolkitVersionPart {
|
|
|
+ public $numA = 0;
|
|
|
+ public $strB = null;
|
|
|
+ public $numC = 0;
|
|
|
+ public $extraD = null;
|
|
|
+}
|
|
|
+
|
|
|
+class ToolkitVersionComparator {
|
|
|
+ public static function compare($a, $b) {
|
|
|
+ do {
|
|
|
+ $va = new ToolkitVersionPart();
|
|
|
+ $vb = new ToolkitVersionPart();
|
|
|
+ $a = self::parseVersionPart($a, $va);
|
|
|
+ $b = self::parseVersionPart($b, $vb);
|
|
|
+
|
|
|
+ $result = self::compareVersionPart($va, $vb);
|
|
|
+
|
|
|
+ if ($result != 0){
|
|
|
+ break;
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ while ($a != null || $b != null);
|
|
|
+
|
|
|
+ if ($result >= 1) { $result = 1; }
|
|
|
+ if ($result <= -1) { $result = -1; }
|
|
|
+
|
|
|
+ return $result;
|
|
|
+ }
|
|
|
+
|
|
|
+
|
|
|
+ private static function parseVersionPart($aVersion, ToolkitVersionPart $result) {
|
|
|
+ if ($aVersion === null || strlen($aVersion) == 0) {
|
|
|
+ return $aVersion;
|
|
|
+ }
|
|
|
+
|
|
|
+ $tok = explode(".", trim($aVersion));
|
|
|
+ $part = $tok[0];
|
|
|
+
|
|
|
+ if ($part == "*") {
|
|
|
+ $result->numA = PHP_INT_MAX;
|
|
|
+ $result->strB = "";
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ $vertok = new ToolkitVersionPartTokenizer($part);
|
|
|
+ $next = $vertok->nextToken();
|
|
|
+ if (is_numeric($next)){
|
|
|
+ $result->numA = $next;
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ $result->numA = 0;
|
|
|
+ }
|
|
|
+
|
|
|
+ if ($vertok->hasMoreElements()) {
|
|
|
+ $str = $vertok->nextToken();
|
|
|
+ // if part is of type "<num>+"
|
|
|
+ if ($str[0] == '+') {
|
|
|
+ $result->numA++;
|
|
|
+ $result->strB = "pre";
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ // else if part is of type "<num><alpha>..."
|
|
|
+ $result->strB = $str;
|
|
|
+
|
|
|
+ if ($vertok->hasMoreTokens()) {
|
|
|
+ $next = $vertok->nextToken();
|
|
|
+ if (is_numeric($next)){
|
|
|
+ $result->numC = $next;
|
|
|
+ }
|
|
|
+ else {
|
|
|
+ $result->numC = 0;
|
|
|
+ }
|
|
|
+ if ($vertok->hasMoreTokens()) {
|
|
|
+ $result->extraD = $vertok->getRemainder();
|
|
|
+ }
|
|
|
+ }
|
|
|
+ }
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ if (sizeOf($tok)>1) {
|
|
|
+ // return everything after "."
|
|
|
+ return substr($aVersion, strlen($part) + 1);
|
|
|
+ }
|
|
|
+
|
|
|
+ return null;
|
|
|
+ }
|
|
|
+
|
|
|
+
|
|
|
+ private static function compareVersionPart(ToolkitVersionPart $va, ToolkitVersionPart $vb) {
|
|
|
+ $res = self::compareInt($va->numA, $vb->numA);
|
|
|
+ if ($res != 0) { return $res; }
|
|
|
+
|
|
|
+ $res = self::compareString($va->strB, $vb->strB);
|
|
|
+ if ($res != 0) { return $res; }
|
|
|
+
|
|
|
+ $res = self::compareInt($va->numC, $vb->numC);
|
|
|
+ if ($res != 0) { return $res; }
|
|
|
+
|
|
|
+ return self::compareString($va->extraD, $vb->extraD);
|
|
|
+ }
|
|
|
+
|
|
|
+
|
|
|
+ private static function compareInt($n1, $n2) { return $n1 - $n2; }
|
|
|
+
|
|
|
+
|
|
|
+ private static function compareString($str1, $str2) {
|
|
|
+ // any string is *before* no string
|
|
|
+ if ($str1 === null) { return ($str2 !== null) ? 1 : 0; }
|
|
|
+ if ($str2 === null) { return -1; }
|
|
|
+ return strcmp($str1, $str2);
|
|
|
+ }
|
|
|
+}
|
|
|
+
|
|
|
+/**
|
|
|
+ * Specialized tokenizer for Mozilla version strings. A token can
|
|
|
+ * consist of one of the four sections of a version string:
|
|
|
+ * <number-a><string-b><number-c><string-d (everything else)>
|
|
|
+ */
|
|
|
+class ToolkitVersionPartTokenizer {
|
|
|
+ private $part = '';
|
|
|
+
|
|
|
+ public function __construct($aPart) { $this->part = $aPart; }
|
|
|
+
|
|
|
+ public function hasMoreElements() { return strlen($this->part) != 0; }
|
|
|
+ public function hasMoreTokens() { return strlen($this->part) != 0; }
|
|
|
+ public function nextToken() { return $this->nextElement(); }
|
|
|
+
|
|
|
+ public function nextElement() {
|
|
|
+ if (preg_match('/^[\+\-]?[0-9].*/', $this->part)) {
|
|
|
+ // if string starts with a number...
|
|
|
+ $index = 0;
|
|
|
+ if ($this->part[0] == '+' || $this->part[0] == '-') {
|
|
|
+ $index = 1;
|
|
|
}
|
|
|
- }
|
|
|
- else {
|
|
|
- $title = 'Output';
|
|
|
- $content = $aContent ?? EMPTY_STRING;
|
|
|
- }
|
|
|
-
|
|
|
- $content = (is_string($content) || is_int($content)) ? $content : json_encode($content, JSON_FLAGS['display']);
|
|
|
-
|
|
|
- // Send the header if not cli
|
|
|
- if (SAPI_IS_CLI) {
|
|
|
- if (!CLI_NO_LOGO) {
|
|
|
- $software = $title . DASH_SEPARATOR . kAppVendor . SPACE . kAppName . SPACE . kAppVersion;
|
|
|
- $titleLength = 120 - 8 - strlen($software);
|
|
|
- $titleLength = ($titleLength > 0) ? $titleLength : 2;
|
|
|
- $title = NEW_LINE . '==' . SPACE . PIPE . SPACE . $software . SPACE . PIPE . SPACE . str_repeat('=', $titleLength);
|
|
|
- $content = $title . NEW_LINE . NEW_LINE . $content . NEW_LINE . NEW_LINE . str_repeat('=', 120) . NEW_LINE;
|
|
|
+ while (($index < strlen($this->part)) && is_numeric($this->part[$index])) {
|
|
|
+ $index++;
|
|
|
}
|
|
|
+ $numPart = substr($this->part, 0, $index);
|
|
|
+ $this->part = substr($this->part, $index);
|
|
|
+ return $numPart;
|
|
|
}
|
|
|
else {
|
|
|
- if (!headers_sent()) {
|
|
|
- self::header($aHeader ?? 'text');
|
|
|
+ // ... or if this is the non-numeric part of version string
|
|
|
+ $index = 0;
|
|
|
+ while (($index < strlen($this->part)) && !is_numeric($this->part[$index])) {
|
|
|
+ $index++;
|
|
|
}
|
|
|
+ $alphaPart = substr($this->part, 0, $index);
|
|
|
+ $this->part = substr($this->part, $index);
|
|
|
+ return $alphaPart;
|
|
|
}
|
|
|
-
|
|
|
- // Write out the content
|
|
|
- print($content);
|
|
|
-
|
|
|
- // We're done here...
|
|
|
- exit();
|
|
|
}
|
|
|
-}
|
|
|
|
|
|
-// ====================================================================================================================
|
|
|
-
|
|
|
-// == | Static Class Init and Global Wrappers | =======================================================================
|
|
|
-
|
|
|
-function gVersionCompare(...$args) { return mozilla\vc\ToolkitVersionComparator::compare(...$args); }
|
|
|
-function gGetArrVal(...$args) { return Illuminate\Support\Arr::get(...$args); }
|
|
|
-function gSetArrVal(...$args) { return Illuminate\Support\Arr::set(...$args); }
|
|
|
-function gUnsetArrVal(...$args) { return Illuminate\Support\Arr::forget(...$args); }
|
|
|
+ /**
|
|
|
+ * Returns what remains of the original string, without tokenization. This
|
|
|
+ * method is useful for getting the <string-d (everything else)>;
|
|
|
+ * section of a version string.
|
|
|
+ *
|
|
|
+ * @return remaining version string
|
|
|
+ */
|
|
|
+ public function getRemainder() { return $this->part; }
|
|
|
+}
|
|
|
|
|
|
-// --------------------------------------------------------------------------------------------------------------------
|
|
|
+} // ==================================================================================================================
|
|
|
|
|
|
-gRegistryUtils::init();
|
|
|
-//gErrorUtils::init();
|
|
|
+namespace Illuminate\Support { // == | ArrayUtils | ===================================================================
|
|
|
|
|
|
-// --------------------------------------------------------------------------------------------------------------------
|
|
|
+/* The Arr class and its methods are under the following license:
|
|
|
|
|
|
-function gGetRegKey(...$args) { return gRegistryUtils::get(...$args); }
|
|
|
-function gSetRegKey(...$args) { return gRegistryUtils::set(...$args); }
|
|
|
-function gSuperGlobal(...$args) { return gRegistryUtils::getGlobalVar(...$args); }
|
|
|
-function gMaybeNull(...$args) { return gRegistryUtils::getGlobalVar('check', ...$args); }
|
|
|
+ The MIT License (MIT)
|
|
|
|
|
|
-// --------------------------------------------------------------------------------------------------------------------
|
|
|
+ Copyright (c) Taylor Otwell
|
|
|
|
|
|
-function gOutput(...$args) { return gConsole::display(...$args); }
|
|
|
-function gHeader(...$args) { return gConsole::header(...$args); }
|
|
|
-function gRedirect(...$args) { return gConsole::redirect(...$args); }
|
|
|
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
|
|
|
+ documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
|
|
|
+ rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
|
|
|
+ persons to whom the Software is furnished to do so, subject to the following conditions:
|
|
|
|
|
|
-// ====================================================================================================================
|
|
|
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions
|
|
|
+ of the Software.
|
|
|
|
|
|
-// == | Global Functions | ============================================================================================
|
|
|
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
|
|
|
+ WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
|
|
+ COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
|
|
|
+ OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
+*/
|
|
|
+class Arr {
|
|
|
+ /**
|
|
|
+ * Get an item from an array using "dot" notation.
|
|
|
+ *
|
|
|
+ * @param \ArrayAccess|array $array
|
|
|
+ * @param string|int|null $key
|
|
|
+ * @param mixed $default
|
|
|
+ * @return mixed
|
|
|
+ */
|
|
|
+ public static function get($array, $key, $default = null)
|
|
|
+ {
|
|
|
+ if (! static::accessible($array)) {
|
|
|
+ return static::value($default);
|
|
|
+ }
|
|
|
|
|
|
-/**********************************************************************************************************************
|
|
|
-* General Error Function
|
|
|
-*
|
|
|
-* @param $aMessage Error message
|
|
|
-**********************************************************************************************************************/
|
|
|
-function gError($aMessage) {
|
|
|
- gOutput($aMessage);
|
|
|
-}
|
|
|
+ if (is_null($key)) {
|
|
|
+ return $array;
|
|
|
+ }
|
|
|
|
|
|
-/**********************************************************************************************************************
|
|
|
-* Registers Files to be included such as components and modules
|
|
|
-***********************************************************************************************************************/
|
|
|
-function gRegisterIncludes($aConst, $aIncludes) {
|
|
|
- if (defined($aConst)) {
|
|
|
- return;
|
|
|
- }
|
|
|
+ if (static::exists($array, $key)) {
|
|
|
+ return $array[$key];
|
|
|
+ }
|
|
|
|
|
|
- $includes = EMPTY_ARRAY;
|
|
|
+ if (! str_contains($key, '.')) {
|
|
|
+ return $array[$key] ?? static::value($default);
|
|
|
+ }
|
|
|
|
|
|
- foreach($aIncludes as $_key => $_value) {
|
|
|
- switch ($aConst) {
|
|
|
- case 'COMPONENTS':
|
|
|
- $includes[$_value] = gPath(ROOT_PATH, 'components', $_value, 'src', $_value . FILE_EXTS['php']);
|
|
|
- break;
|
|
|
- case 'MODULES':
|
|
|
- $includes[$_value] = gPath(ROOT_PATH, 'modules', $_value . FILE_EXTS['php']);
|
|
|
- break;
|
|
|
- case 'LIBRARIES':
|
|
|
- if (str_contains($_value, DOT . DOT)) {
|
|
|
- return;
|
|
|
+ foreach (explode('.', $key) as $segment) {
|
|
|
+ if (static::accessible($array) && static::exists($array, $segment)) {
|
|
|
+ $array = $array[$segment];
|
|
|
+ } else {
|
|
|
+ return static::value($default);
|
|
|
+ }
|
|
|
}
|
|
|
|
|
|
- $includes[$_key] = gPath(ROOT_PATH, 'third_party', $_value);
|
|
|
- break;
|
|
|
- default:
|
|
|
- gfError('Unknown include type');
|
|
|
+ return $array;
|
|
|
}
|
|
|
- }
|
|
|
-
|
|
|
- define($aConst, $includes);
|
|
|
-}
|
|
|
-
|
|
|
-/**********************************************************************************************************************
|
|
|
-* Basic Filter Substitution of a string
|
|
|
-*
|
|
|
-* @dep EMPTY_STRING
|
|
|
-* @dep SLASH
|
|
|
-* @dep SPACE
|
|
|
-* @dep gError()
|
|
|
-* @param $aSubsts multi-dimensional array of keys and values to be replaced
|
|
|
-* @param $aString string to operate on
|
|
|
-* @param $aRegEx set to true if pcre
|
|
|
-* @returns bitwise int value representing applications
|
|
|
-***********************************************************************************************************************/
|
|
|
-function gSubst(string $aString, array $aSubsts, bool $aRegEx = false) {
|
|
|
- $rv = $aString;
|
|
|
- $replaceFunction = $aRegEx ? 'preg_replace' : 'str_replace';
|
|
|
-
|
|
|
- foreach ($aSubsts as $_key => $_value) {
|
|
|
- $rv = call_user_func($replaceFunction, ($aRegEx ? SLASH . $_key . SLASH . 'iU' : $_key), $_value, $rv);
|
|
|
- }
|
|
|
-
|
|
|
- return !$rv ? gError('Something has gone wrong...') : $rv;
|
|
|
-}
|
|
|
-
|
|
|
-/**********************************************************************************************************************
|
|
|
-* Explodes a string to an array without empty elements if it starts or ends with the separator
|
|
|
-*
|
|
|
-* @dep DASH_SEPARATOR
|
|
|
-* @dep gError()
|
|
|
-* @param $aSeparator Separator used to split the string
|
|
|
-* @param $aString String to be exploded
|
|
|
-* @returns Array of string parts
|
|
|
-***********************************************************************************************************************/
|
|
|
-function gSplitStr(string $aSeparator, string $aString) {
|
|
|
- return (!str_contains($aString, $aSeparator)) ? [$aString] :
|
|
|
- array_values(array_filter(explode($aSeparator, $aString), 'strlen'));
|
|
|
-}
|
|
|
-function gSplitString(...$args) { return gSplitStr(...$args); }
|
|
|
-
|
|
|
-/**********************************************************************************************************************
|
|
|
-* Splits a path into an indexed array of parts
|
|
|
-*
|
|
|
-* @dep SLASH
|
|
|
-* @dep gSplitString()
|
|
|
-* @param $aPath URI Path
|
|
|
-* @returns array of uri parts in order
|
|
|
-***********************************************************************************************************************/
|
|
|
-function gSplitPath(string $aPath) {
|
|
|
- return ($aPath == SLASH) ? ['root'] : gSplitString(SLASH, $aPath);
|
|
|
-}
|
|
|
-
|
|
|
-/**********************************************************************************************************************
|
|
|
-* Builds and Normalizes Paths
|
|
|
-***********************************************************************************************************************/
|
|
|
-function gPath(...$aParts) {
|
|
|
- $parts = EMPTY_ARRAY;
|
|
|
- $path = strtr(implode(SLASH, $aParts), '\\', SLASH);
|
|
|
- $prefix = EMPTY_STRING;
|
|
|
- $absolute = false;
|
|
|
-
|
|
|
- // extract a prefix being a protocol://, protocol:, protocol://drive: or simply drive:
|
|
|
- if (preg_match('{^( [0-9a-z]{2,}+: (?: // (?: [a-z]: )? )? | [a-z]: )}ix', $path, $match)) {
|
|
|
- $prefix = $match[1];
|
|
|
- $path = substr($path, strlen($prefix));
|
|
|
- }
|
|
|
-
|
|
|
- if (substr($path, 0, 1) === SLASH) {
|
|
|
- $absolute = true;
|
|
|
- $path = substr($path, 1);
|
|
|
- }
|
|
|
-
|
|
|
- $up = false;
|
|
|
|
|
|
- foreach (explode(SLASH, $path) as $chunk) {
|
|
|
- if (DOTDOT === $chunk && ($absolute || $up)) {
|
|
|
- array_pop($parts);
|
|
|
- $up = !(empty($parts) || DOTDOT === end($parts));
|
|
|
- }
|
|
|
- elseif (DOT !== $chunk && EMPTY_STRING !== $chunk) {
|
|
|
- $parts[] = $chunk;
|
|
|
- $up = DOTDOT !== $chunk;
|
|
|
+ /**
|
|
|
+ * Determine whether the given value is array accessible.
|
|
|
+ *
|
|
|
+ * @param mixed $value
|
|
|
+ * @return bool
|
|
|
+ */
|
|
|
+ public static function accessible($value)
|
|
|
+ {
|
|
|
+ return is_array($value) || $value instanceof ArrayAccess;
|
|
|
}
|
|
|
- }
|
|
|
-
|
|
|
- return $prefix . ($absolute ? SLASH : EMPTY_STRING) . implode(SLASH, $parts);
|
|
|
-}
|
|
|
|
|
|
-/**********************************************************************************************************************
|
|
|
-* Strips the constant ROOT_PATH from a string
|
|
|
-*
|
|
|
-* @dep ROOT_PATH
|
|
|
-* @dep EMPTY_STRING
|
|
|
-* @param $aPath Path to be stripped
|
|
|
-* @returns Stripped path
|
|
|
-***********************************************************************************************************************/
|
|
|
-function gStripSubstr(string $aStr, ?string $aStripStr = null) {
|
|
|
- return str_replace($aStripStr ?? ROOT_PATH, EMPTY_STRING, $aStr);
|
|
|
-}
|
|
|
-
|
|
|
-/**********************************************************************************************************************
|
|
|
-* Hash a password
|
|
|
-***********************************************************************************************************************/
|
|
|
-function gPasswordHash(string $aPassword, mixed $aCrypt = PASSWORD_BCRYPT, ?string $aSalt = null) {
|
|
|
- switch ($aCrypt) {
|
|
|
- case PASSWORD_CLEARTEXT:
|
|
|
- // We can "hash" a cleartext password by prefixing it with the fake algo prefix $clear$
|
|
|
- if (str_contains($aPassword, DOLLAR)) {
|
|
|
- // Since the dollar sign is used as an identifier and/or separator for hashes we can't use passwords
|
|
|
- // that contain said dollar sign.
|
|
|
- gError('Cannot "hash" this Clear Text password because it contains a dollar sign.');
|
|
|
- }
|
|
|
-
|
|
|
- return DOLLAR . PASSWORD_CLEARTEXT . DOLLAR . time() . DOLLAR . $aPassword;
|
|
|
- case PASSWORD_HTACCESS:
|
|
|
- // We want to be able to generate Apache APR1-MD5 hashes for use in .htpasswd situations.
|
|
|
- $salt = $aSalt;
|
|
|
+ /**
|
|
|
+ * Determine if the given key exists in the provided array.
|
|
|
+ *
|
|
|
+ * @param \ArrayAccess|array $array
|
|
|
+ * @param string|int $key
|
|
|
+ * @return bool
|
|
|
+ */
|
|
|
+ public static function exists($array, $key)
|
|
|
+ {
|
|
|
+ if ($array instanceof ArrayAccess) {
|
|
|
+ return $array->offsetExists($key);
|
|
|
+ }
|
|
|
+ return array_key_exists($key, $array);
|
|
|
+ }
|
|
|
|
|
|
- if (!$salt) {
|
|
|
- $salt = EMPTY_STRING;
|
|
|
+ /**
|
|
|
+ * Return the default value of the given value.
|
|
|
+ *
|
|
|
+ * @param mixed $value
|
|
|
+ * @return mixed
|
|
|
+ */
|
|
|
+ public static function value($value)
|
|
|
+ {
|
|
|
+ return $value instanceof Closure ? $value() : $value;
|
|
|
+ }
|
|
|
|
|
|
- for ($i = 0; $i < 8; $i++) {
|
|
|
- $offset = hexdec(bin2hex(openssl_random_pseudo_bytes(1))) % 64;
|
|
|
- $salt .= APRMD5_ALPHABET[$offset];
|
|
|
+ /**
|
|
|
+ * Set an array item to a given value using "dot" notation.
|
|
|
+ *
|
|
|
+ * If no key is given to the method, the entire array will be replaced.
|
|
|
+ *
|
|
|
+ * @param array $array
|
|
|
+ * @param string|int|null $key
|
|
|
+ * @param mixed $value
|
|
|
+ * @return array
|
|
|
+ */
|
|
|
+ public static function set(&$array, $key, $value)
|
|
|
+ {
|
|
|
+ if (is_null($key)) {
|
|
|
+ return $array = $value;
|
|
|
}
|
|
|
- }
|
|
|
-
|
|
|
- $salt = substr($salt, 0, 8);
|
|
|
- $max = strlen($aPassword);
|
|
|
- $context = $aPassword . DOLLAR . PASSWORD_HTACCESS . DOLLAR . $salt;
|
|
|
- $binary = pack('H32', md5($aPassword . $salt . $aPassword));
|
|
|
|
|
|
- for ($i = $max; $i > 0; $i -= 16) {
|
|
|
- $context .= substr($binary, 0, min(16, $i));
|
|
|
- }
|
|
|
+ $keys = explode('.', $key);
|
|
|
|
|
|
- for ($i = $max; $i > 0; $i >>= 1) {
|
|
|
- $context .= ($i & 1) ? chr(0) : $aPassword[0];
|
|
|
- }
|
|
|
+ foreach ($keys as $i => $key) {
|
|
|
+ if (count($keys) === 1) {
|
|
|
+ break;
|
|
|
+ }
|
|
|
|
|
|
- $binary = pack('H32', md5($context));
|
|
|
+ unset($keys[$i]);
|
|
|
|
|
|
- for ($i = 0; $i < 1000; $i++) {
|
|
|
- $new = ($i & 1) ? $aPassword : $binary;
|
|
|
+ // If the key doesn't exist at this depth, we will just create an empty array
|
|
|
+ // to hold the next value, allowing us to create the arrays to hold final
|
|
|
+ // values at the correct depth. Then we'll keep digging into the array.
|
|
|
+ if (! isset($array[$key]) || ! is_array($array[$key])) {
|
|
|
+ $array[$key] = [];
|
|
|
+ }
|
|
|
|
|
|
- if ($i % 3) {
|
|
|
- $new .= $salt;
|
|
|
- }
|
|
|
- if ($i % 7) {
|
|
|
- $new .= $aPassword;
|
|
|
+ $array = &$array[$key];
|
|
|
}
|
|
|
|
|
|
- $new .= ($i & 1) ? $binary : $aPassword;
|
|
|
- $binary = pack('H32', md5($new));
|
|
|
+ $array[array_shift($keys)] = $value;
|
|
|
+
|
|
|
+ return $array;
|
|
|
}
|
|
|
|
|
|
- $hash = EMPTY_STRING;
|
|
|
+ /**
|
|
|
+ * Remove one or many array items from a given array using "dot" notation.
|
|
|
+ *
|
|
|
+ * @param array $array
|
|
|
+ * @param array|string|int|float $keys
|
|
|
+ * @return void
|
|
|
+ */
|
|
|
+ public static function forget(&$array, $keys)
|
|
|
+ {
|
|
|
+ $original = &$array;
|
|
|
|
|
|
- for ($i = 0; $i < 5; $i++) {
|
|
|
- $k = $i + 6;
|
|
|
- $j = $i + 12;
|
|
|
- if($j == 16) $j = 5;
|
|
|
- $hash = $binary[$i] . $binary[$k] . $binary[$j] . $hash;
|
|
|
- }
|
|
|
+ $keys = (array) $keys;
|
|
|
|
|
|
- $hash = chr(0) . chr(0) . $binary[11] . $hash;
|
|
|
- $hash = strtr(strrev(substr(base64_encode($hash), 2)), BASE64_ALPHABET, APRMD5_ALPHABET);
|
|
|
+ if (count($keys) === 0) {
|
|
|
+ return;
|
|
|
+ }
|
|
|
|
|
|
- return DOLLAR . PASSWORD_HTACCESS . DOLLAR . $salt . DOLLAR . $hash;
|
|
|
- default:
|
|
|
- // Else, our standard (and secure) default is PASSWORD_BCRYPT hashing.
|
|
|
- // We do not allow custom salts for anything using password_hash as PHP generates secure salts.
|
|
|
- // PHP Generated passwords are also self-verifiable via password_verify.
|
|
|
- return password_hash($aPassword, $aCrypt);
|
|
|
- }
|
|
|
-}
|
|
|
+ foreach ($keys as $key) {
|
|
|
+ // if the exact key exists in the top-level, remove it
|
|
|
+ if (static::exists($array, $key)) {
|
|
|
+ unset($array[$key]);
|
|
|
|
|
|
-/**********************************************************************************************************************
|
|
|
-* Check a password
|
|
|
-***********************************************************************************************************************/
|
|
|
-function gPasswordVerify(string $aPassword, string $aHash) {
|
|
|
- // We can accept a pseudo-hash for clear text passwords in the format of $clrtxt$unix-epoch$clear-text-password
|
|
|
- if (str_starts_with($aHash, DOLLAR . PASSWORD_CLEARTEXT)) {
|
|
|
- $password = gSplitString(DOLLAR, $aHash) ?? null;
|
|
|
+ continue;
|
|
|
+ }
|
|
|
|
|
|
- if ($password == null || count($password) > 3) {
|
|
|
- gError('Unable to "verify" this Clear Text "hashed" password.');
|
|
|
- }
|
|
|
+ $parts = explode('.', $key);
|
|
|
|
|
|
- return $aPassword === $password[2];
|
|
|
- }
|
|
|
+ // clean up before each pass
|
|
|
+ $array = &$original;
|
|
|
|
|
|
- // We can also accept an Apache APR1-MD5 password that is commonly used in .htpasswd
|
|
|
- if (str_starts_with($aHash, DOLLAR . PASSWORD_HTACCESS)) {
|
|
|
- $salt = gSplitString(DOLLAR, $aHash)[1] ?? null;
|
|
|
+ while (count($parts) > 1) {
|
|
|
+ $part = array_shift($parts);
|
|
|
|
|
|
- if(!$salt) {
|
|
|
- gError('Unable to verify this Apache APR1-MD5 hashed password.');
|
|
|
+ if (isset($array[$part]) && static::accessible($array[$part])) {
|
|
|
+ $array = &$array[$part];
|
|
|
+ } else {
|
|
|
+ continue 2;
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ unset($array[array_shift($parts)]);
|
|
|
+ }
|
|
|
}
|
|
|
|
|
|
- return gPasswordHash($aPassword, PASSWORD_HTACCESS, $salt) === $aHash;
|
|
|
- }
|
|
|
+ /**
|
|
|
+ * Flatten a multi-dimensional associative array with dots.
|
|
|
+ *
|
|
|
+ * @param iterable $array
|
|
|
+ * @param string $prepend
|
|
|
+ * @return array
|
|
|
+ */
|
|
|
+ public static function dot($array, $prepend = '')
|
|
|
+ {
|
|
|
+ $results = [];
|
|
|
|
|
|
- // For everything else send to the native password_verify function.
|
|
|
- // It is almost certain to be a BCRYPT2 hash but hashed passwords generated BY PHP are self-verifiable.
|
|
|
- return password_verify($aPassword, $aHash);
|
|
|
-}
|
|
|
+ foreach ($array as $key => $value) {
|
|
|
+ if (is_array($value) && ! empty($value)) {
|
|
|
+ $results = array_merge($results, static::dot($value, $prepend.$key.'.'));
|
|
|
+ } else {
|
|
|
+ $results[$prepend.$key] = $value;
|
|
|
+ }
|
|
|
+ }
|
|
|
|
|
|
-/**********************************************************************************************************************
|
|
|
-* Generates a v4 random guid or a "v4bis" guid with static vendor node
|
|
|
-***********************************************************************************************************************/
|
|
|
-function gGUID(?string $aVendor = null, $aXPCOM = null) {
|
|
|
- if ($aVendor) {
|
|
|
- if (strlen($aVendor) < 3) {
|
|
|
- gError('v4bis GUIDs require a defined vendor of more than three characters long.');
|
|
|
+ return $results;
|
|
|
}
|
|
|
|
|
|
- // Generate 8 pseudo-random bytes
|
|
|
- $bytes = random_bytes(8);
|
|
|
-
|
|
|
- // Knock the vendor down to lowercase so we can simply use a switch case
|
|
|
- $vendor = strtolower($aVendor);
|
|
|
+ /**
|
|
|
+ * Convert a flatten "dot" notation array into an expanded array.
|
|
|
+ *
|
|
|
+ * @param iterable $array
|
|
|
+ * @return array
|
|
|
+ */
|
|
|
+ public static function undot($array)
|
|
|
+ {
|
|
|
+ $results = [];
|
|
|
|
|
|
- // We want "v4bis" GUIDs with the static vendor part to match the broken version of GUIDGenX for known nodes
|
|
|
- // as Moonchild half-assed his tool that he wrote for this and by the time it was discovered several were already
|
|
|
- // using the previous incorrect GUIDs.
|
|
|
- $knownVendorNodes = array(
|
|
|
- 'binoc' => hex2bin('8b97957ad5f8ea47'),
|
|
|
- 'binoc-legacy' => hex2bin('9aa0aa0e607640b9'),
|
|
|
- 'mcp' => hex2bin('bfc5fc555c87dbc4'),
|
|
|
- 'lootyhoof' => hex2bin('b98e98e62085837f'),
|
|
|
- 'pseudo-static' => hex2bin('93763763d1ad1978')
|
|
|
- );
|
|
|
+ foreach ($array as $key => $value) {
|
|
|
+ static::set($results, $key, $value);
|
|
|
+ }
|
|
|
|
|
|
- switch ($vendor) {
|
|
|
- case 'binoc':
|
|
|
- case 'binaryoutcast':
|
|
|
- case 'binary outcast':
|
|
|
- $bytes .= $knownVendorNodes['binoc'];
|
|
|
- break;
|
|
|
- case 'pseudo-static':
|
|
|
- case 'pseudostatic':
|
|
|
- case 'addons':
|
|
|
- case 'add-ons':
|
|
|
- case 'apmo':
|
|
|
- $bytes .= $knownVendorNodes['pseudo-static'];
|
|
|
- break;
|
|
|
- case 'mcp':
|
|
|
- case 'moonchildproductions':
|
|
|
- case 'moonchild productions':
|
|
|
- $bytes .= $knownVendorNodes['mcp'];
|
|
|
- break;
|
|
|
- case 'binoc-legacy':
|
|
|
- case 'lootyhoof':
|
|
|
- $bytes .= $knownVendorNodes[$vendor];
|
|
|
- break;
|
|
|
- default:
|
|
|
- // Since this isn't a known busted vendor node then we should generate it ourselves.
|
|
|
- // This matches the fixed version of GUIDGenX 1.1 which is to md5 hash the vendor string then
|
|
|
- // split it in half and XOR the two parts for the final value
|
|
|
- $vendor = hash('md5', $aVendor);
|
|
|
- $bytes .= hex2bin(substr($vendor, 0, 16)) ^ hex2bin(substr($vendor, 16, 32));
|
|
|
+ return $results;
|
|
|
}
|
|
|
- }
|
|
|
- else {
|
|
|
- // This is a pure v4 UUID spec which is 16 pseudo-random bytes.
|
|
|
- $bytes = random_bytes(16);
|
|
|
- }
|
|
|
+
|
|
|
+}
|
|
|
|
|
|
- // Set the version and variant
|
|
|
- // NOTE: Like everything Moonzilla does, he did not set the variant value when he initially came up with "v4bis"
|
|
|
- // putting a busted generator into production use for the whole team. Sad!
|
|
|
- $bytes[6] = chr(ord($bytes[6]) & 0x0f | 0x40);
|
|
|
- $bytes[8] = chr(ord($bytes[8]) & 0x3f | 0x80);
|
|
|
+} // ==================================================================================================================
|
|
|
|
|
|
- $hex = bin2hex($bytes);
|
|
|
- $guid = vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split($hex, 4));
|
|
|
+namespace { // == | Bootstrap | =======================================================================================
|
|
|
|
|
|
- // We want the GUID in XPIDL/C++ Header notation
|
|
|
- if ($aXPCOM) {
|
|
|
- $explode = gSplitString(DASH, $guid);
|
|
|
- $rv = "%{C++" . NEW_LINE . "//" . SPACE . "{" . $guid . "}" . NEW_LINE .
|
|
|
- "#define NS_CHANGE_ME_IID" . SPACE .
|
|
|
- vsprintf("{ 0x%s, 0x%s, 0x%s, { 0x%s, 0x%s, 0x%s, 0x%s, 0x%s, 0x%s, 0x%s, 0x%s } }",
|
|
|
- [$explode[0], $explode[1], $explode[2],
|
|
|
- substr($explode[3], 0, 2), substr($explode[3], 2, 2),
|
|
|
- substr($explode[4], 0, 2), substr($explode[4], 2, 2), substr($explode[4], 4, 2),
|
|
|
- substr($explode[4], 6, 2), substr($explode[4], 8, 2), substr($explode[4], 10, 2)]) . NEW_LINE .
|
|
|
- "%}";
|
|
|
- }
|
|
|
- else {
|
|
|
- // We like Microsoft GUID notation not UUID which means Lisa needs braces.. I mean the GUID.
|
|
|
- $rv = '{' . $guid . '}';
|
|
|
- }
|
|
|
+// If the uri is /special/ then don't even bother loading the rest of the code
|
|
|
+// We can also specify to always default to the special component
|
|
|
+if ((gRegistryUtils::Component('site') && gRegistry('app.path.0') == kSpecialComponent) ||
|
|
|
+ gRegistry('constant.appIsSpecialComponent')) {
|
|
|
+ gRegistrySet('app.component', kSpecialComponent);
|
|
|
+ gLoadComponent();
|
|
|
+}
|
|
|
|
|
|
- return $rv;
|
|
|
+// If this is going to be apart of a larger application then why not detect and load it up. Else, we will continue
|
|
|
+// back to the script that included us where we will need to handle some form of output if there is any.
|
|
|
+if (file_exists(gPath(ROOT_PATH, 'base', 'src', 'app.php'))) {
|
|
|
+ require_once(gPath(ROOT_PATH, 'base', 'src', 'app.php'));
|
|
|
+ gError('PC LOAD LETTER');
|
|
|
}
|
|
|
|
|
|
-// ====================================================================================================================
|
|
|
-}
|
|
|
+} // ==================================================================================================================
|
