X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=application%2FUtils.php;h=cb03f11c7fd556098674055739a0cf8d8c2300fa;hb=67ee1435f8a92894b6bf08404b5d26a3141c0b9e;hp=82220bfc4399b69c68d6b9c1e459d12339c33461;hpb=64bc92e3ac8f5e66d2bc14206ede31e6679d8c13;p=github%2Fshaarli%2FShaarli.git diff --git a/application/Utils.php b/application/Utils.php old mode 100644 new mode 100755 index 82220bfc..cb03f11c --- a/application/Utils.php +++ b/application/Utils.php @@ -48,7 +48,7 @@ function endsWith($haystack, $needle, $case=true) */ function nl2br_escaped($html) { - return str_replace('>','>',str_replace('<','<',nl2br($html))); + return str_replace('>', '>', str_replace('<', '<', nl2br($html))); } /** @@ -69,4 +69,96 @@ function sanitizeLink(&$link) $link['description'] = escape($link['description']); $link['tags'] = escape($link['tags']); } -?> + +/** + * Checks if a string represents a valid date + * + * @param string a string-formatted date + * @param format the expected DateTime format of the string + * @return whether the string is a valid date + * @see http://php.net/manual/en/class.datetime.php + * @see http://php.net/manual/en/datetime.createfromformat.php + */ +function checkDateFormat($format, $string) +{ + $date = DateTime::createFromFormat($format, $string); + return $date && $date->format($string) == $string; +} + +/** + * Generate a header location from HTTP_REFERER. + * Make sure the referer is Shaarli itself and prevent redirection loop. + * + * @param string $referer - HTTP_REFERER. + * @param string $host - Server HOST. + * @param array $loopTerms - Contains list of term to prevent redirection loop. + * + * @return string $referer - final referer. + */ +function generateLocation($referer, $host, $loopTerms = array()) +{ + $final_referer = '?'; + + // No referer if it contains any value in $loopCriteria. + foreach ($loopTerms as $value) { + if (strpos($referer, $value) !== false) { + return $final_referer; + } + } + + // Remove port from HTTP_HOST + if ($pos = strpos($host, ':')) { + $host = substr($host, 0, $pos); + } + + if (!empty($referer) && strpos(parse_url($referer, PHP_URL_HOST), $host) !== false) { + $final_referer = $referer; + } + + return $final_referer; +} + +/** + * Checks the PHP version to ensure Shaarli can run + * + * @param string $minVersion minimum PHP required version + * @param string $curVersion current PHP version (use PHP_VERSION) + * + * @throws Exception the PHP version is not supported + */ +function checkPHPVersion($minVersion, $curVersion) +{ + if (version_compare($curVersion, $minVersion) < 0) { + throw new Exception( + 'Your PHP version is obsolete!' + .' Shaarli requires at least PHP '.$minVersion.', and thus cannot run.' + .' Your PHP version has known security vulnerabilities and should be' + .' updated as soon as possible.' + ); + } +} + +/** + * Validate session ID to prevent Full Path Disclosure. + * See #298. + * + * @param string $sessionId Session ID + * + * @return true if valid, false otherwise. + */ +function is_session_id_valid($sessionId) +{ + if (empty($sessionId)) { + return false; + } + + if (!$sessionId) { + return false; + } + + if (!preg_match('/^[a-z0-9]{2,32}$/i', $sessionId)) { + return false; + } + + return true; +}