25 class TemplateParser {
29 protected $templateDir;
39 protected $forceRecompile =
false;
45 public function __construct( $templateDir =
null, $forceRecompile =
false ) {
46 $this->templateDir = $templateDir ?: __DIR__ .
'/templates';
47 $this->forceRecompile = $forceRecompile;
56 protected function getTemplateFilename( $templateName ) {
61 strcspn( $templateName,
":/\\\000&<>'\"%" ) !== strlen( $templateName )
63 throw new UnexpectedValueException(
"Malformed \$templateName: $templateName" );
66 return "{$this->templateDir}/{$templateName}.mustache";
75 protected function getTemplate( $templateName ) {
77 if ( isset( $this->renderers[$templateName] ) &&
78 is_callable( $this->renderers[$templateName] )
80 return $this->renderers[$templateName];
83 $filename = $this->getTemplateFilename( $templateName );
85 if ( !file_exists( $filename ) ) {
86 throw new RuntimeException(
"Could not locate template: {$filename}" );
90 $fileContents = file_get_contents( $filename );
93 $fastHash = md5( $fileContents );
96 $config = MediaWikiServices::getInstance()->getMainConfig();
97 $secretKey = $config->get(
'SecretKey' );
102 $key =
$cache->makeKey(
'template', $templateName, $fastHash );
103 $code = $this->forceRecompile ? null :
$cache->get( $key );
107 $keyedHash = substr(
$code, 0, 64 );
109 if ( $keyedHash !== hash_hmac(
'sha256',
$code, $secretKey ) ) {
116 $code = $this->compileForEval( $fileContents, $filename );
123 $code = $this->compileForEval( $fileContents, $filename );
126 $renderer = eval(
$code );
127 if ( !is_callable( $renderer ) ) {
128 throw new RuntimeException(
"Requested template, {$templateName}, is not callable" );
130 $this->renderers[$templateName] = $renderer;
142 protected function compileForEval( $fileContents, $filename ) {
144 $code = $this->compile( $fileContents );
147 throw new RuntimeException(
"Could not compile template: {$filename}" );
151 if ( substr(
$code, 0, 5 ) ===
'<?php' ) {
164 protected function compile(
$code ) {
165 if ( !class_exists(
'LightnCandy' ) ) {
166 throw new RuntimeException(
'LightnCandy class not defined' );
168 return LightnCandy::compile(
173 'flags' => LightnCandy::FLAG_ERROR_EXCEPTION,
174 'basedir' => $this->templateDir,
175 'fileext' =>
'.mustache',
197 public function processTemplate( $templateName,
$args,
array $scopes = [] ) {
198 $template = $this->getTemplate( $templateName );