$key using this search criteria: * - if $key is a constant then return it. Else * - if $key is set in $_ENV then return it. Else * - return $def. * * @param string $key The key to search for. * @param string $def The default value to return. * @return string the string value of the system property, or the default * value if there is no property with that key. * * @static */ public static function getSystemProperty($key, $def) { if(defined($key)) { return (string)constant($key); } else if(isset($_SERVER[$key])) { return (string)$_SERVER[$key]; } else if(isset($_ENV[$key])) { return (string)$_ENV[$key]; } else { return $def; } } /** * If $value is true, then true is * returned. If $value is false, then * true is returned. Otherwise, $default is * returned. * *
Case of value is unimportant.
* * @param string $value * @param boolean $default * @return boolean * * @static */ public static function toBoolean($value, $default=true) { if (is_null($value)) { return $default; } elseif (is_string($value)) { $trimmedVal = strtolower(trim($value)); if("1" == $trimmedVal or "true" == $trimmedVal or "yes" == $trimmedVal or "on" == $trimmedVal) { return true; } else if ("" == $trimmedVal or "0" == $trimmedVal or "false" == $trimmedVal or "no" == $trimmedVal or "off" == $trimmedVal) { return false; } } elseif (is_bool($value)) { return $value; } elseif (is_int($value)) { return !($value == 0); // true is everything but 0 like in C } trigger_error("Could not convert ".var_export($value,1)." to boolean!", E_USER_WARNING); return $default; } /** * @param string $value * @param integer $default * @return integer * @static */ public static function toInt($value, $default) { $value = trim($value); if(is_numeric($value)) { return (int)$value; } else { return $default; } } /** * Converts a standard or custom priority level to a Level * object. * *If $value is of form "level#full_file_classname", * where full_file_classname means the class filename with path * but without php extension, then the specified class' toLevel() method * is called to process the specified level string; if no '#' * character is present, then the default {@link LoggerLevel} * class is used to process the level value.
* *As a special case, if the $value parameter is * equal to the string "NULL", then the value null will * be returned.
* *If any error occurs while converting the value to a level, * the $defaultValue parameter, which may be * null, is returned.
* *Case of $value is insignificant for the level level, but is * significant for the class name part, if present.
* * @param string $value * @param LoggerLevel $defaultValue * @return LoggerLevel a {@link LoggerLevel} or null * @static */ public static function toLevel($value, $defaultValue) { if($value === null) { return $defaultValue; } $hashIndex = strpos($value, '#'); if($hashIndex === false) { if("NULL" == strtoupper($value)) { return null; } else { // no class name specified : use standard Level class return LoggerLevel::toLevel($value, $defaultValue); } } $result = $defaultValue; $clazz = substr($value, ($hashIndex + 1)); $levelName = substr($value, 0, $hashIndex); // This is degenerate case but you never know. if("NULL" == strtoupper($levelName)) { return null; } $clazz = basename($clazz); if(class_exists($clazz)) { $result = @call_user_func(array($clazz, 'toLevel'), $levelName, $defaultValue); if(!$result instanceof LoggerLevel) { $result = $defaultValue; } } return $result; } /** * @param string $value * @param float $default * @return float * * @static */ public static function toFileSize($value, $default) { if($value === null) { return $default; } $s = strtoupper(trim($value)); $multiplier = (float)1; if(($index = strpos($s, 'KB')) !== false) { $multiplier = 1024; $s = substr($s, 0, $index); } else if(($index = strpos($s, 'MB')) !== false) { $multiplier = 1024 * 1024; $s = substr($s, 0, $index); } else if(($index = strpos($s, 'GB')) !== false) { $multiplier = 1024 * 1024 * 1024; $s = substr($s, 0, $index); } if(is_numeric($s)) { return (float)$s * $multiplier; } return $default; } /** * Find the value corresponding to $key in * $props. Then perform variable substitution on the * found value. * * @param string $key * @param array $props * @return string * * @static */ public static function findAndSubst($key, $props) { $value = @$props[$key]; // If coming from the LoggerConfiguratorIni, some options were // already mangled by parse_ini_file: // // not specified => never reaches this code // ""|off|false|null => string(0) "" // "1"|on|true => string(1) "1" // "true" => string(4) "true" // "false" => string(5) "false" // // As the integer 1 and the boolean true are therefore indistinguable // it's up to the setter how to deal with it, they can not be cast // into a boolean here. {@see toBoolean} // Even an empty value has to be given to the setter as it has been // explicitly set by the user and is different from an option which // has not been specified and therefore keeps its default value. // // if(!empty($value)) { return LoggerOptionConverter::substVars($value, $props); // } } /** * Perform variable substitution in string $val from the * values of keys found with the {@link getSystemProperty()} method. * *The variable substitution delimeters are ${ and }. * *
For example, if the "MY_CONSTANT" contains "value", then
* the call
*
* $s = LoggerOptionConverter::substituteVars("Value of key is ${MY_CONSTANT}.");
*
* will set the variable $s to "Value of key is value.".
If no value could be found for the specified key, then the * $props parameter is searched, if the value could not * be found there, then substitution defaults to the empty string.
* *For example, if {@link getSystemProperty()} cannot find any value for the key
* "inexistentKey", then the call
*
* $s = LoggerOptionConverter::substVars("Value of inexistentKey is [${inexistentKey}]");
*
* will set $s to "Value of inexistentKey is []".
A warn is thrown if $val contains a start delimeter "${" * which is not balanced by a stop delimeter "}" and an empty string is returned.
* * @author Avy Sharell * * @param string $val The string on which variable substitution is performed. * @param array $props * @return string * * @static */ // TODO: this method doesn't work correctly with key = true, it needs key = "true" which is odd public static function substVars($val, $props = null) { $sbuf = ''; $i = 0; while(true) { $j = strpos($val, self::DELIM_START, $i); if($j === false) { // no more variables if($i == 0) { // this is a simple string return $val; } else { // add the tail string which contails no variables and return the result. $sbuf .= substr($val, $i); return $sbuf; } } else { $sbuf .= substr($val, $i, $j-$i); $k = strpos($val, self::DELIM_STOP, $j); if($k === false) { // LoggerOptionConverter::substVars() has no closing brace. Opening brace return ''; } else { $j += self::START_LEN; $key = substr($val, $j, $k - $j); // first try in System properties $replacement = LoggerOptionConverter::getSystemProperty($key, null); // then try props parameter if($replacement == null and $props !== null) { $replacement = @$props[$key]; } if(!empty($replacement)) { // Do variable substitution on the replacement string // such that we can solve "Hello ${x2}" as "Hello p1" // the where the properties are // x1=p1 // x2=${x1} $recursiveReplacement = LoggerOptionConverter::substVars($replacement, $props); $sbuf .= $recursiveReplacement; } $i = $k + self::DELIM_STOP_LEN; } } } } }