X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;ds=sidebyside;f=application%2FUtils.php;h=bcf5bdb58130efae179a9879e2bf6660ce51d226;hb=69c474b96612dc64fc2cb66f1196251cafa08445;hp=aeaef9ff143a84e67f16bb99365fcdbd70680608;hpb=822bffced8212e7f34bcb2ad063b31a78bd57bdb;p=github%2Fshaarli%2FShaarli.git diff --git a/application/Utils.php b/application/Utils.php index aeaef9ff..bcf5bdb5 100644 --- a/application/Utils.php +++ b/application/Utils.php @@ -3,6 +3,24 @@ * Shaarli utilities */ +/** + * Logs a message to a text file + * + * The log format is compatible with fail2ban. + * + * @param string $logFile where to write the logs + * @param string $clientIp the client's remote IPv4/IPv6 address + * @param string $message the message to log + */ +function logm($logFile, $clientIp, $message) +{ + file_put_contents( + $logFile, + date('Y/m/d H:i:s').' - '.$clientIp.' - '.strval($message).PHP_EOL, + FILE_APPEND + ); +} + /** * Returns the small hash of a string, using RFC 4648 base64url format * @@ -44,19 +62,27 @@ function endsWith($haystack, $needle, $case=true) } /** - * Same as nl2br(), but escapes < and > + * Htmlspecialchars wrapper + * + * @param string $str the string to escape. + * + * @return string escaped. */ -function nl2br_escaped($html) +function escape($str) { - return str_replace('>', '>', str_replace('<', '<', nl2br($html))); + return htmlspecialchars($str, ENT_COMPAT, 'UTF-8', false); } /** - * htmlspecialchars wrapper + * Reverse the escape function. + * + * @param string $str the string to unescape. + * + * @return string unescaped string. */ -function escape($str) +function unescape($str) { - return htmlspecialchars($str, ENT_COMPAT, 'UTF-8', false); + return htmlspecialchars_decode($str); } /** @@ -200,6 +226,31 @@ function space2nbsp($text) * * @return string formatted description. */ -function format_description($description, $redirector) { +function format_description($description, $redirector = false) { return nl2br(space2nbsp(text2clickable($description, $redirector))); } + +/** + * Sniff browser language to set the locale automatically. + * Note that is may not work on your server if the corresponding locale is not installed. + * + * @param string $headerLocale Locale send in HTTP headers (e.g. "fr,fr-fr;q=0.8,en;q=0.5,en-us;q=0.3"). + **/ +function autoLocale($headerLocale) +{ + // Default if browser does not send HTTP_ACCEPT_LANGUAGE + $attempts = array('en_US'); + if (isset($headerLocale)) { + // (It's a bit crude, but it works very well. Preferred language is always presented first.) + if (preg_match('/([a-z]{2})-?([a-z]{2})?/i', $headerLocale, $matches)) { + $loc = $matches[1] . (!empty($matches[2]) ? '_' . strtoupper($matches[2]) : ''); + $attempts = array( + $loc.'.UTF-8', $loc, str_replace('_', '-', $loc).'.UTF-8', str_replace('_', '-', $loc), + $loc . '_' . strtoupper($loc).'.UTF-8', $loc . '_' . strtoupper($loc), + $loc . '_' . $loc.'.UTF-8', $loc . '_' . $loc, $loc . '-' . strtoupper($loc).'.UTF-8', + $loc . '-' . strtoupper($loc), $loc . '-' . $loc.'.UTF-8', $loc . '-' . $loc + ); + } + } + setlocale(LC_ALL, $attempts); +} \ No newline at end of file