萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Smarty 模板引擎 {foreach} 循環標籤解析與編譯實現

模板語法

{foreach ( from=url key=b item=c )}
    <a href="index.php?artcle_id={==b}">{==c}</a>
{/foreach}

解析引擎實現步驟

1. 變量標籤預處理

$pattern_var = "/\{\$([\w\d]+)\}/";
$replace_var = '<?php echo $this->var_tpl_arr["$1"]; ?>';
$content = preg_replace($pattern_var, $replace_var, $content);

2. 解析 {foreach ...}

preg_match_all("/\{foreach\s+([^{]+?)\}/is", $content, $match_foreach);

if (isset($match_foreach[1]) && is_array($match_foreach[1])) {
    foreach ($match_foreach[1] as $match_key => $match_value) {
        // 解析屬性:from、item、key
        $split_foreachs = array_filter(preg_split('/\s+/is', $match_value));
        $new_foreach_tag = array();
        foreach ($split_foreachs as $split_foreach) {
            $split = explode("=", $split_foreach);
            if (count($split) == 2) {
                if (in_array($split[0], array("from", "item", "key"))) {
                    $new_foreach_tag[$split[0]] = $split[1];
                }
            }
        }

        $from = $key = $item = '';
        extract($new_foreach_tag); // $from, $key, $item
        $key = ($key) ? '$'.$key.' =>' : ''; // 若有 key 則生成 $key =>

        // 替換為 PHP foreach
        $replace_foreach = '<?php foreach($this->var_tpl_arr["'.$from.'"] as '.$key.' $'.$item.') { ?>';
        $content = str_replace($match_foreach[0][$match_key], $replace_foreach, $content);
    }
}

3. 解析 {/foreach}

$pattern_foreach_close = "/\{\/foreach\}/";
$replace_foreach_close = "<?php } ?>";
$content = preg_replace($pattern_foreach_close, $replace_foreach_close, $content);

4. 解析循環內變量 {==var}

$pattern_var_in = "/\{==([\w\d]+)\}/";
$replace_var_in = '<?php echo $$1; ?>'; // 注意雙$:循環變量是局部變量
$content = preg_replace($pattern_var_in, $replace_var_in, $content);

完整模板編譯前後對比

模板文件

<!DOCTYPE html>
<html><head><title>{$web_tile}</title></head><body>
{$article_title}<br/>-- by {$author}<hr/>{$content}<br/>-- publish @ {$time}
<br/><br/>foreach test:
{foreach ( from=url key=b item=c )}
    <a href="index.php?artcle_id={==b}">{==c}</a>
{/foreach}
</body></html>

編譯後 PHP 緩存

<!DOCTYPE html>
<html><head><title><?php echo $this->var_tpl_arr["web_tile"]; ?></title></head><body>
<?php echo $this->var_tpl_arr["article_title"]; ?><br/>-- by <?php echo $this->var_tpl_arr["author"]; ?><hr/><?php echo $this->var_tpl_arr["content"]; ?><br/>-- publish @ <?php echo $this->var_tpl_arr["time"]; ?>
<br/><br/>foreach test:
<?php foreach($this->var_tpl_arr["url"] as $b => $c) { ?>
    <a href="index.php?artcle_id=<?php echo $b; ?>"><?php echo $c; ?></a>
<?php } ?>
</body></html>

使用示例

<?php
require_once 'core/YATP.class.php'; // 假設引擎類文件
$tpl = new YATP();
$tpl->assign('web_tile', '我的博客');
$tpl->assign('article_title', 'Smarty foreach 教程');
$tpl->assign('author', '張三');
$tpl->assign('content', '內容...');
$tpl->assign('time', date('Y-m-d H:i:s'));
$tpl->assign('url', array(
    101 => '文章一',
    102 => '文章二',
    103 => '文章三',
));
$tpl->display('template.html');
?>

注意事項

  1. {==var} 僅在 {foreach}、{section} 等循環作用域內有效,對應 PHP 循環變量。
  2. 屬性值若含空格或特殊字符,建議用引號包裹:from="my array",解析器需相應支持。
  3. 嵌套循環時,內層 {==var} 會覆蓋外層同名變量,注意變量名衝突。
  4. 生產級引擎建議引入 模板繼承、沙箱模式、編譯緩存 機制。
copyright © 萬盛學電腦網 all rights reserved