Dirt-простые шаблоны PHP … может ли это работать без `eval`?

PHP сам по себе был предназначен как язык шаблонов (т. Е. Простой способ разрешить вам встраивать код внутри HTML).

Как вы видите из ваших собственных примеров, это слишком сложно, чтобы оправдать использование таким образом большую часть времени, поэтому хорошая практика отошла от этого, чтобы использовать его больше как традиционный язык и только вырваться из <?php ?> как можно меньше.

Проблема заключалась в том, что люди все еще хотели использовать язык шаблонов, поэтому были созданы платформы, такие как Smarty. Но если вы посмотрите на них сейчас, Smarty поддерживает такие вещи, как свои собственные переменные и петли foreach … и вскоре шаблоны Smarty начинают иметь те же проблемы, что и используемые шаблоны PHP; вы, возможно, просто использовали родной PHP в первую очередь.

То, что я пытаюсь сказать здесь, состоит в том, что идеалы простого шаблонного языка на самом деле не так понятны. Практически невозможно сделать это достаточно простым, чтобы не отпугивать дизайнеров и в то же время дать ему достаточно гибкости, чтобы фактически делать то, что вам нужно.

Я собираюсь сделать что-то глупое и предложить что-то, что вообще не требует шаблонизационного движка, и требует только не более 5 символов за переменную / вызов, чем то, что у вас там, – замените {$foo} на <?=$foo?> затем вы можете использовать include для всех ваших потребностей в шаблонах

Если все, что вам нужно, это замена переменных, хотя это функция шаблонов, которую я фактически использую:

 function fillTemplate($tplName,$tplVars){ $tpl=file_get_contents("tplDir/".$tplName); foreach($tplVars as $k=>$v){ $tpl = preg_replace('/{'.preg_quote($k).'}/',$v,$tpl); } return $tpl; } 

если вы хотите иметь возможность вызывать функции или иметь циклы, практически нет способа вызвать eval, который не предваряется предварительной обработкой.

Если вы не хотите использовать большие движки шаблонов, такие как Twig (что я искренне рекомендую), вы все равно можете получить хорошие результаты с небольшим кодом.

Основная идея, что все механизмы шаблонов поделиться, состоит в том, чтобы скомпилировать шаблон с дружественным, понятным синтаксисом для быстрого и кэшируемого кода PHP. Обычно они выполняли бы это путем анализа исходного кода и последующего его компиляции. Но даже если вы не хотите использовать что-то сложное, вы можете добиться хороших результатов, используя регулярные выражения.

Итак, основная идея:

 function renderTemplate($templateName, $templateVars) { $templateLocation = 'tpl/' . $templateName . '.php'; $cacheLocation = 'tplCache/' . $templateName . '.php'; if (!file_exists($cacheLocation) || filemtime($cacheLocation) < filemtime($templateLocation)) { // compile template and save to cache location } // extract template variables ($templateVars['a'] => $a) extract($templateVars); // run template include 'tplCache/' . $templateName . '.php'; } 

Поэтому мы сначала скомпилируем шаблон, а затем выполним его. Компиляция выполняется только в том случае, если либо кешированный шаблон еще не существует, либо существует более новая версия шаблона, чем та, что находится в кеше.

Итак, давайте поговорим о компиляции. Мы определим два синтаксиса: для вывода и для структур управления. Вывод всегда экранируется по умолчанию. Если вы не хотите этого избежать, вы должны отметить его как «безопасный». Это дает дополнительную безопасность. Итак, вот пример нашего синтаксиса:

 {% foreach ($posts as $post): } <h1>{ $post->name }</h1> <p>{ $post->body }</p> {!! $post->link } {% endforeach; } 

Итак, вы используете { something } чтобы убежать и что-то эха. Вы используете {!! something} {!! something} чтобы непосредственно что-то повторять, не ускользая от него. И вы используете {% command } чтобы выполнить некоторый бит PHP-кода, не повторяя его (например, для структур управления).

Итак, вот код компиляции:

 $code = file_get_contents($templateLocation); $code = preg_replace('~\{\s*(.+?)\s*\}~', '<?php echo htmlspecialchars($1, ENT_QUOTES) ?>', $code); $code = preg_replace('~\{!!\s*(.+?)\s*\}~', '<?php echo $1 ?>', $code); $code = preg_replace('~\{%\s*(.+?)\s*\}~', '<?php $1 ?>', $code); file_put_contents($cacheLocation, $code); 

Вот и все. Вы, однако, должны отметить, что это больше подвержено ошибкам, чем реальный механизм шаблонов. Но это будет работать в большинстве случаев. Кроме того, обратите внимание, что это позволяет писателю шаблона выполнить произвольный код. Это и про и кон.

Итак, вот весь код:

 function renderTemplate($templateName, $templateVars) { $templateLocation = 'tpl/' . $templateName . '.php'; $cacheLocation = 'tplCache/' . $templateName . '.php'; if (!file_exists($cacheLocation) || filemtime($cacheLocation) < filemtime($templateLocation)) { $code = file_get_contents($templateLocation); $code = preg_replace('~\{\s*(.+?)\s*\}~', '<?php echo htmlspecialchars($1, ENT_QUOTES) ?>', $code); $code = preg_replace('~\{!!\s*(.+?)\s*\}~', '<?php echo $1 ?>', $code); $code = preg_replace('~\{%\s*(.+?)\s*\}~', '<?php $1 ?>', $code); file_put_contents($cacheLocation, $code); } // extract template variables ($templateVars['a'] => $a) extract($templateVars, EXTR_SKIP); // run template include 'tplCache/' . $templateName . '.php'; } 

Я не тестировал вышеуказанный код;) Это только основная идея.

Окончательного решения нет. У каждого есть плюсы и минусы. Но вы уже пришли к выводу, чего хотите. И это кажется очень разумным направлением. Поэтому я предлагаю вам найти наиболее эффективный способ его достижения.

В основном вам нужно только приложить свои документы в синтаксическом сахаре heredoc. В начале каждого файла:

 <?=<<<EOF 

И в конце каждого файла шаблона:

 EOF; ?> 

Награда за достижение. Но, очевидно, это смущает большинство синтаксических движков подсветки. Я мог бы исправить свой текстовый редактор, это с открытым исходным кодом. Но Dreamweaver – это совсем другое дело. Поэтому единственным полезным вариантом является использование небольшого сценария предварительного компилятора, который может конвертировать между шаблонами с необработанными $ varnames-HTML и шаблонами, заключенными в Heredoc. Это очень простой подход к regex и перезаписи файлов:

 #!/usr/bin/php -Cq <?php foreach (glob("*.tpl") as $fn) { $file = file_get_contents($fn); if (preg_match("/<\?.+<<</m")) { // remove $file = preg_replace("/<\?(=|php\s+print)\s*<<<\s*EOF\s*|\s+EOF;\s*\?>\s*/m", "", $file); } else { // add heredoc wrapper $file = "<?php print <<<EOF\n" . trim($file) . "\nEOF;\n?>"; } file_put_contents($fn, $file); } ?> 

Это заданное – где-то вам понадобятся шаблоны с небольшим количеством логики if-else. Поэтому для последовательной обработки вам необходимо, чтобы все шаблоны действовали как правильный PHP без специальной обертки обработки eval / regex. Это позволяет вам легко переключаться между шаблонами heredoc, но также иметь несколько с обычным выходом <?php print . Смешивайте и сопоставляйте по мере необходимости, и дизайнеры могут работать с большинством файлов, но избегать нескольких сложных случаев. Для примера для моих шаблонов я часто использую только:

 include(template("index")); // works for heredoc & normal php templ 

Нет дополнительного обработчика и работает как с общими типами шаблонов (raw php и smartyish html-файлы). Единственным недостатком является случайное использование сценария конвертера.

Я также добавил бы extract(array_map("htmlspecialchars",get_defined_vars())); поверх каждого шаблона для обеспечения безопасности.

Во всяком случае, ваш метод passthrough является исключительно умным, я должен сказать. Я бы назвал псевдоним heredoc $php , поэтому $_ все еще доступен для gettext.

 <a href="calc.html">{$php(1+5+7*3)}</a> is more readable than Smarty 

Я думаю, что сам собираюсь принять этот трюк.

 <div>{$php(include(template($ifelse ? "if.tpl" : "else.tpl")))}</div> 

Немного растягивает, но, кажется, после всех возможных есть простая логика в шаблонах heredoc. Может привести к шаблону-fileritis, но помогает обеспечить наиболее простой шаблон логики.

Offtopic: Если три <<<heredoc&EOF; синтаксические линии все еще кажутся слишком грязными, тогда лучший вариант no-eval использует парсер, основанный на регулярном выражении. Я не согласен с распространенным мифом о том, что это медленнее, чем собственный PHP. На самом деле я считаю, что токенизатор PHP и парсер отстают от PCRE. Особенно, если речь идет только об интерполирующих переменных. Просто последнее не является APC / Zend-кэшем, вы сами по себе будете там.

Лично я бы не трогал палкой любую систему шаблонов, где забывание избежать переменной создает уязвимость удаленного выполнения кода.

Лично я использую этот механизм шаблонов: http://articles.sitepoint.com/article/beyond-template-engine/5

Мне это очень нравится, особенно потому, что это простота. Это похоже на вашу последнюю инкарнацию, но IMHO – лучший подход, чем использование heredoc и создание еще одного слоя синтаксического анализа над PHP. Также нет eval (), но буферизация вывода и скопированные переменные шаблона. Используйте следующее:

 <?php require_once('template.php'); // Create a template object for the outer template and set its variables. $tpl = new Template('./templates/'); $tpl->set('title', 'User List'); // Create a template object for the inner template and set its variables. // The fetch_user_list() function simply returns an array of users. $body = new Template('./templates/'); $body->set('user_list', fetch_user_list()); // Set the fetched template of the inner template to the 'body' variable // in the outer template. $tpl->set('body', $body->fetch('user_list.tpl.php')); // Echo the results. echo $tpl->fetch('index.tpl.php'); ?> 

Шаблон внешнего шаблона будет выглядеть так:

 <html> <head> <title><?=$title;?></title> </head> <body> <h2><?=$title;?></h2> <?=$body;?> </body> </html> 

и внутренний (входит в переменную $body body шаблона outter) следующим образом:

 <table> <tr> <th>Id</th> <th>Name</th> <th>Email</th> <th>Banned</th> </tr> <? foreach($user_list as $user): ?> <tr> <td align="center"><?=$user['id'];?></td> <td><?=$user['name'];?></td> <td><a href="mailto:<?=$user['email'];?>"><?=$user['email'];?></a></td> <td align="center"><?=($user['banned'] ? 'X' : '&nbsp;');?></td> </tr> <? endforeach; ?> </table> - <table> <tr> <th>Id</th> <th>Name</th> <th>Email</th> <th>Banned</th> </tr> <? foreach($user_list as $user): ?> <tr> <td align="center"><?=$user['id'];?></td> <td><?=$user['name'];?></td> <td><a href="mailto:<?=$user['email'];?>"><?=$user['email'];?></a></td> <td align="center"><?=($user['banned'] ? 'X' : '&nbsp;');?></td> </tr> <? endforeach; ?> </table> 

Если вам не нравятся / не могут использовать короткие теги, замените их на эхо. Это так же близко к грязи, как вы можете получить, но при этом все функции вам понадобится IMHO.

Dead-simple templating с использованием функции:

 <?php function template($color) { $template = <<< ENDTEMPLATE The colors I like are {$color} and purple. ENDTEMPLATE; return $template . "\n"; } $color = 'blue'; echo template($color); $color = 'turquoise'; echo template($color); 

Эти результаты:

 The colors I like are blue and purple. The colors I like are turquoise and purple. 

Ничего необычного, но он работает с использованием стандартного PHP без расширений. Кроме того, использование функций для инкапсуляции шаблонов должно помочь с надлежащим разделением MVC. Также (и это то, что мне нужно для моего кодирования сегодня). Я могу сохранить заполненный шаблон для вывода в файл (позже в моей программе).

Это минимальная реализация усов, чтобы просто заменить переменные.

 // Example: // miniMustache( // "{{documentName }} - pag {{ page.current }} / {{ page.total }}", // array( // 'documentName' => 'YourCompany Homepage', // 'page' => array('current' => 1, 'total' => 10) // ) // ) // // Render: "YourCompany Homepage - pag 1 / 10" function miniMustache($tmpl, $vars){ return preg_replace_callback( '/\{\{([A-z0-9_\.\s]+)\}\}/', function ($matches) use ($vars) { //Remove white spaces and split by "." $var = explode('.',preg_replace('/[\s]/', '', $matches[1])); $value = $vars; foreach($var as $el){ $value = $value[$el]; } return $value; }, $tmpl); } 

В некоторых случаях этого более чем достаточно. Если вам нужна полная мощность: https://github.com/bobthecow/mustache.php