13c0fcd869
Add note that on change in lib/ folder (add/name/delete) 'composer dump-autoload' must be run to update the composer auto loader as this is currently on testing to not use internal autoloader update all composer/vender autoload configs Check\Basic: just apply updates in deprecated method calls Check\Jason: has been deprecaged and moved to Convert\Json. Primary issue was wrong name "Jason" instead of "Json" Check\Password: only Check\PhpVersion: fix version check for >9 numbers Combined\Array: variable name change to be more clear, all searches are strict for recoursive search, new option for recoursive search many to return only found array data and no control array info. for backwards compatible this is default set to ($old = true) and needs to be set to false to get the new format, array search normal has a new strict flag for forcing strict compare on search. remove some unneeded is_array checks, fixed the flatten array to key to not only use leave elements, but all array keys, if only leaves are wanted the new method flattenArrayKeyLeavesOnly only returns key from leaves Combined\DateTime: checkDateTime got more correct error checks on invalid data compareDate uses strtotimestamp for more easier compare like compareDateTime does, both to a check on inalid timestamp now calcDaysInterval also aborts on invalid data now Convert\Byte: str to bytes does not drop the minus sign anymore Convert\Colors: any error will now return false and not set to some neutral gray. also fix missing round on hsb/hsl special return groups Convert\Html: add constants for CHECKED/SELECTED options, fix remove linebreak to not add two spaces if \r\n was found Convert\Json: moved from Check\Jason and add two new error types Convert\MimeAppName: do not set if mime type or app name is empty Create\Hash: add crc32b to hash allows types so we can create a normal not reversed crc32b Create\Uids: move default hash type to var in class, fix defined constant check Debug\FileWriter: add log folder setting to override config constant settings and also check if we can actually write to the folder and if BASE and LOG constants are not empty Get\System: add constant for getPageName and fix getHostName to be more shorter and faster Language\L10n: remove \Basic class extends because we don't need it there at all Template\SmartyExtend: fix constant check
96 lines
2.8 KiB
PHP
96 lines
2.8 KiB
PHP
<?php
|
|
|
|
/*
|
|
* Converts a json string to array and stores error for later checking
|
|
* can also return empty array on demand
|
|
* and self set json as is on error as array
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace CoreLibs\Convert;
|
|
|
|
class Json
|
|
{
|
|
/** @var int */
|
|
private static $json_last_error;
|
|
|
|
/**
|
|
* converts a json string to an array
|
|
* or inits an empty array on null string
|
|
* or failed convert to array
|
|
* In ANY case it will ALWAYS return array.
|
|
* Does not throw errors
|
|
* @param string|null $json a json string, or null data
|
|
* @param bool $override if set to true, then on json error
|
|
* set original value as array
|
|
* @return array<mixed> returns an array from the json values
|
|
*/
|
|
public static function jsonConvertToArray(?string $json, bool $override = false): array
|
|
{
|
|
if ($json !== null) {
|
|
$_json = json_decode($json, true);
|
|
if (self::$json_last_error = json_last_error()) {
|
|
if ($override == true) {
|
|
// init return as array with original as element
|
|
$json = [$json];
|
|
} else {
|
|
$json = [];
|
|
}
|
|
} else {
|
|
$json = $_json;
|
|
}
|
|
} else {
|
|
$json = [];
|
|
}
|
|
// be sure that we return an array
|
|
return (array)$json;
|
|
}
|
|
|
|
/**
|
|
* returns human readable string for json errors thrown in jsonConvertToArray
|
|
* @param bool|boolean $return_string [default=false] if set to true
|
|
* it will return the message string and not
|
|
* the error number
|
|
* @return int|string Either error number (0 for no error)
|
|
* or error string ('' for no error)
|
|
*/
|
|
public static function jsonGetLastError(bool $return_string = false)
|
|
{
|
|
$json_error_string = '';
|
|
// valid errors as of php 8.0
|
|
switch (self::$json_last_error) {
|
|
case JSON_ERROR_NONE:
|
|
$json_error_string = '';
|
|
break;
|
|
case JSON_ERROR_DEPTH:
|
|
$json_error_string = 'Maximum stack depth exceeded';
|
|
break;
|
|
case JSON_ERROR_STATE_MISMATCH:
|
|
$json_error_string = 'Underflow or the modes mismatch';
|
|
break;
|
|
case JSON_ERROR_CTRL_CHAR:
|
|
$json_error_string = 'Unexpected control character found';
|
|
break;
|
|
case JSON_ERROR_SYNTAX:
|
|
$json_error_string = 'Syntax error, malformed JSON';
|
|
break;
|
|
case JSON_ERROR_UTF8:
|
|
$json_error_string = 'Malformed UTF-8 characters, possibly incorrectly encoded';
|
|
break;
|
|
case JSON_ERROR_INVALID_PROPERTY_NAME:
|
|
$json_error_string = 'A key starting with \u0000 character was in the string';
|
|
break;
|
|
case JSON_ERROR_UTF16:
|
|
$json_error_string = 'Single unpaired UTF-16 surrogate in unicode escape';
|
|
break;
|
|
default:
|
|
$json_error_string = 'Unknown error';
|
|
break;
|
|
}
|
|
return $return_string === true ? $json_error_string : self::$json_last_error;
|
|
}
|
|
}
|
|
|
|
// __END__
|