[ "parser" => function() { throw new Exception("No parser registered!"); }, "hash_generator" => function() { throw new Exception("No parser registered!"); } ] ]; /** * Registers a new parser. * @package core * @param string $name The name of the new parser to register. * @param callable $parser_code The function to register as a new parser. * @param callable $hash_generator A function that should take a single argument of the input source text, and return a unique hash for that content. The return value is used as the filename for cache entries, so should be safe to use as such. */ function add_parser($name, $parser_code, $hash_generator) { global $parsers; if(isset($parsers[$name])) throw new Exception("Can't register parser with name '$name' because a parser with that name already exists."); $parsers[$name] = [ "parser" => $parser_code, "hash_generator" => $hash_generator ]; } /** * Parses the specified page source using the parser specified in the settings * into HTML. * The specified parser may (though it's unlikely) render it to other things. * @package core * @param string $source The source to render. * @param bool $use_cache Whether to use the on-disk cache. Has no effect if parser caching is disabled in peppermint.json, or the source string is too small. * @param bool $untrusted Whether the source string is 'untrusted' - i.e. a user comment. Untrusted source disallows HTML and protects against XSS attacks. * @return string The source rendered to HTML. */ function parse_page_source($source, $untrusted = false, $use_cache = true) { global $settings, $paths, $parsers, $version; $start_time = microtime(true); if(!$settings->parser_cache || strlen($source) < $settings->parser_cache_min_size) $use_cache = false; if(!isset($parsers[$settings->parser])) exit(page_renderer::render_main("Parsing error - $settings->sitename", "

Parsing some page source data failed. This is most likely because $settings->sitename has the parser setting set incorrectly. Please contact " . hide_email($settings->admindetails_email, $settings->admindetails_name) . ", $settings->sitename's Administrator.")); /* Not needed atm because escaping happens when saving, not when rendering * if($settings->clean_raw_html) $source = htmlentities($source, ENT_QUOTES | ENT_HTML5); */ $cache_id = $parsers[$settings->parser]["hash_generator"]($source); $cache_file = "{$paths->cache_directory}/{$cache_id}.html"; $result = null; if($use_cache && file_exists($cache_file)) { $result = file_get_contents($cache_file); $result .= "\n\n"; } if($result == null) { $result = $parsers[$settings->parser]["parser"]($source, $untrusted); // If we should use the cache and we failed to write to it, warn the admin. // It's not terribible if we can't write to the cache directory (so we shouldn't stop dead & refuse service), but it's still of concern. if($use_cache && !file_put_contents($cache_file, $result)) error_log("[PeppermintyWiki/$settings->sitename/parser_engine] Warning: Failed to write to cache file $cache_file."); $result .= "\n\n"; } return $result; }